capistrano

KO | EN

gitlite — search

#python #hacktoberfest #react #llm #machine-learning #deep-learning #docker #windows #awesome #cli #awesome-list #security #openai #ios

(★ 12,982)

Ruby, Rake, 그리고 SSH 기반으로 구축된 배포 자동화 도구입니다.

capistrano 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Capistrano: Ruby, Rake, SSH로 구축된 배포 자동화 도구
[![Gem Version](https://badge.fury.io/rb/capistrano.svg)](https://badge.fury.io/rb/capistrano) [![Build Status](https://github.com/capistrano/capistrano/actions/workflows/ci.yml/badge.svg)](https://github.com/capistrano/capistrano/actions/workflows/ci.yml) [![Code Climate](https://codeclimate.com/github/capistrano/capistrano/badges/gpa.svg)](https://codeclimate.com/github/capistrano/capistrano) [![CodersClan](https://img.shields.io/badge/get-support-blue.svg)](https://codersclan.net/?repo\_id=325&source=small)

Capistrano는 자동화된 배포 스크립트를 만들기 위한 프레임워크입니다. Capistrano 자체는 Ruby로 작성되어 있지만, Rails, Java, PHP 등 언어와 프레임워크에 구애받지 않고 어떤 프로젝트든 손쉽게 배포하는 데 사용할 수 있습니다.

일단 설치하고 나면, 커맨드라인 환경에서 편하게 배포를 수행할 수 있는 `cap` 도구가 제공됩니다.

```
$ cd my-capistrano-enabled-project
$ cap production deploy
```

`cap`을 실행하면 Capistrano가 충실하게 SSH를 통해 서버에 접속하여 프로젝트 배포에 필요한 단계를 실행합니다. [Rake](https://github.com/ruby/rake) 태스크를 직접 작성하거나, Capistrano 커뮤니티에서 제공하는 사전 구축된 태스크 라이브러리를 사용하여 이러한 단계를 정의할 수 있습니다.

태스크는 만들기 매우 간단합니다. 다음은 예시입니다:

```ruby
task :restart\_sidekiq do
on roles(:worker) do
execute :service, "sidekiq restart"
end
end
after "deploy:published", "restart\_sidekiq"
```

\*참고: 이 문서는 현재 버전의 Capistrano(3.x)를 위한 것입니다. Capistrano 2.x 문서를 찾고 계시다면 [이 아카이브](https://github.com/capistrano/capistrano-2.x-docs)에서 확인하실 수 있습니다.\*

---

## 목차

\* [기능](#features)
\* [주의사항](#gotchas)
\* [빠른 시작](#quick-start)
\* [도움말 및 문서 찾기](#finding-help-and-documentation)
\* [기여하는 방법](#how-to-contribute)
\* [라이선스](#license)

## 기능

간단한 rsync bash 스크립트부터 복잡한 컨테이너 기반 툴체인에 이르기까지, 배포를 자동화하는 방법은 다양합니다. Capistrano는 그 중간 지점에 위치합니다. SSH를 통해 수동으로 수행하던 작업을 반복 가능하고 확장 가능한 방식으로 자동화해 줍니다. 마법 같은 것은 없습니다!

Capistrano가 훌륭한 이유는 다음과 같습니다:

#### 강력한 규칙 (Conventions)
Capistrano는 Capistrano를 사용하는 모든 프로젝트가 기본적으로 따르는 표준 배포 프로세스를 정의합니다. 스크립트를 어떻게 구조화해야 할지, 배포된 파일이 서버의 어디에 위치해야 할지, 공통 작업을 어떻게 수행해야 할지 고민할 필요가 없습니다. Capistrano가 이미 다 해놓았으니까요.

#### 다중 스테이지
배포를 한 번 정의한 후, `qa`, `staging`, `production` 같은 여러 \*스테이지\* (환경)에 맞춰 쉽게 매개변수화할 수 있습니다. 복사해서 붙여넣을 필요가 없습니다. IP 주소와 같이 스테이지별로 다른 부분만 지정해주면 됩니다.

#### 병렬 실행
수많은 앱 서버에 배포해야 하나요? Capistrano는 각 서버에서 배포 태스크를 동시에 실행할 수 있으며, 속도를 위해 커넥션 풀링(connection pooling)을 사용합니다.

#### 서버 역할
애플리케이션을 운영하다 보면 데이터베이스 서버, 앱 서버, 두 대의 웹 서버, 작업 큐 워커 서버 등 다양한 유형의 서버가 필요할 수 있습니다. Capistrano는 각 서버에 하나 이상의 역할을 태그로 지정할 수 있게 해주므로, 어떤 태스크가 어디서 실행될지 제어할 수 있습니다.

#### 커뮤니티 중심
Capistrano는 rubygems 패키지 매니저를 사용하여 쉽게 확장할 수 있습니다. Rails 앱을 배포하시나요? Wordpress인가요? Laravel인가요? 누군가 이미 여러분이 선택한 프레임워크용 Capistrano 태스크를 작성하여 gem으로 배포해 두었을 확률이 높습니다. 많은 Ruby 프로젝트에도 Capistrano 태스크가 기본적으로 포함되어 있습니다.

#### 그냥 SSH일 뿐입니다
Capistrano의 모든 것은 원격 서버에서 SSH 명령어를 실행하는 것으로 귀결됩니다. 한편으로는 이 덕분에 Capistrano가 단순해집니다. 다른 한편으로는, 리눅스 박스에 SSH로 접속해 커맨드라인에서 무언가를 다루는 것이 불편하다면 Capistrano는 아마 맞지 않을 것입니다.

## 주의사항

Capistrano는 모든 유형의 배포에 공통적인 강력한 규칙들을 기본 제공하지만,

ents, 프로젝트의 세부 사항을 이해하는 데는 도움이 필요하며, Capistrano가 수행하기에 적합하지 않은 작업들도 일부 존재합니다.
#### 프로젝트 세부 사항
기본적으로 Capistrano는 코드를 서버에 배포할 수 있지만, 코드를 *실행*하는 방법은 알지 못합니다. `foreman`을 실행해야 합니까? Apache를 재시작해야 합니까? 이러한 배포 단계를 직접 작성하거나, 이를 대신해 주는 Capistrano 커뮤니티의 gem을 찾아 Capistrano에 방법을 알려주어야 합니다.
#### 키 기반 SSH
Capistrano는 키 기반(즉, 비밀번호 없는) 인증을 사용하여 SSH로 서버에 연결하는 방식에 의존합니다. Capistrano를 사용하려면 이 기능이 먼저 작동해야 합니다.
#### 프로비저닝
마찬가지로, 배포를 수행하기 전에 서버에 지원 소프트웨어가 설치되어 있어야 할 수 있습니다. Capistrano 자체는 SSH 외에 다른 요구 사항이 없지만, 애플리케이션에는 아마도 데이터베이스 소프트웨어, Apache나 Nginx 같은 웹 서버, 그리고 Java, Ruby, PHP 같은 언어 런타임이 필요할 것입니다. 이러한 *서버 프로비저닝* 단계는 Capistrano가 수행하지 않습니다.
#### `sudo` 등
Capistrano는 권한이 없는 단일 SSH 사용자를 사용하고 *비대화형* SSH 세션을 사용하여 배포하도록 설계되었습니다. 배포에 `sudo`, 대화형 프롬프트, 한 사용자로 인증하면서 다른 사용자로 명령을 실행하는 작업 등이 필요한 경우 Capistrano로 달성할 수는 있겠지만 어려울 수 있습니다. 이러한 요구 사항을 피할 수 있다면 자동화된 배포가 훨씬 더 원활해질 것입니다.
#### 셸
Capistrano 3은 Bash나 Sh 같은 POSIX 셸을 가정합니다. tcsh, csh 같은 셸은 작동할 수도 있지만, 아마도 작동하지 않을 것입니다.
## 빠른 시작
### 요구 사항
* 로컬 머신에 Ruby 버전 2.5 이상 (MRI 또는 Rubinius)
* 형상 관리를 사용하는 프로젝트 (Git, Mercurial, Subversion 지원 내장)
* 배포할 서버에 프로젝트를 체크아웃하는 데 필요한 SCM 바이너리(예: `git`, `hg`)가 설치되어 있어야 함
* 프로젝트의 Gemfile과 함께 [Bundler](https://bundler.io) 권장
### Capistrano gem 설치
`require: false`를 사용하여 프로젝트의 Gemfile에 Capistrano를 추가합니다.
``` ruby
group :development do
gem "capistrano", "~> 3.17", require: false
end
```
그런 다음 Bundler를 실행하여 Capistrano가 다운로드되고 설치되었는지 확인합니다.
``` sh
$ bundle install
```
### 프로젝트 "Capify" 하기
프로젝트에 이미 "Capfile"이나 "capfile"이 없는지 확인합니다. 그런 다음 실행합니다.
``` sh
$ bundle exec cap install
```
그러면 `staging`과 `production`의 두 가지 스테이지를 가진 Capistrano 지원 프로젝트에 필요한 모든 설정 파일과 디렉토리 구조가 생성됩니다.
```
├── Capfile
├── config
│ ├── deploy
│ │ ├── production.rb
│ │ └── staging.rb
│ └── deploy.rb
└── lib
└── capistrano
└── tasks
```
생성될 스테이지를 커스터마이즈하려면 다음을 사용합니다.
``` sh
$ bundle exec cap install STAGES=local,sandbox,qa,production
```
Capistrano가 생성하는 파일은 단순히 시작을 돕기 위한 템플릿일 뿐입니다. 프로젝트와 대상 서버에 적절한 값이 포함되도록 `deploy.rb`와 스테이지 파일을 반드시 수정하세요.
### 명령줄 사용법
``` sh
# 사용 가능한 모든 작업 나열
$ bundle exec cap -T
# staging 환경에 배포
$ bundle exec cap staging deploy
# production 환경에 배포
$ bundle exec cap production deploy
# production 환경에 배포 시뮬레이션
# 실제로 아무 작업도 수행하지 않음
$ bundle exec cap production deploy --dry-run
# 작업 의존성 나열
$ bundle exec cap production deploy --prereqs
# 작업 호출 추적
$ bundle exec cap production deploy --trace
# 배포 작업 전에 모든 설정 변수 나열
$ bundle exec cap production deploy --print-config-variables
```
## 도움말 및 문서 찾기
Capistrano는 여러 개의 GitHub 리포지토리와 플러그인 커뮤니티를 아우르는 대규모 프로젝트이므로, 처음 시작할 때는 압도될 수 있습니다. 도움이 될 수 있는 리소스는 다음과 같습니다.
* \*\*[docs](docs) 디렉토리는 공식 문서를 포함하고 있으며,\*\* 생성하는 데 사용됩니다

[Capistrano 웹사이트](https://capistranorb.com)를 방문해 보세요.
\* [Stack Overflow](https://stackoverflow.com/questions/tagged/capistrano)에는 활발하게 활동이 이루어지는 Capistrano 태그가 있습니다.
\* [Capistrano 메일링 리스트](https://groups.google.com/forum/#!forum/capistrano)는 트래픽이 적지만 Capistrano 기여자들이 모니터링하고 있습니다.
\* [Codersclan](https://codersclan.net/?repo\_id=325&source=link)에는 현금을 걸고 문제를 해결해 줄 수 있는 Capistrano 전문가들이 있습니다.
관련 GitHub 저장소:
\* [capistrano/sshkit](https://github.com/capistrano/sshkit)은 Capistrano의 기반이 되는 SSH 동작을 제공합니다(Capistrano 태스크에서 `execute`를 사용할 때 SSHKit을 사용하고 있는 것입니다).
\* [capistrano/rails](https://github.com/capistrano/rails)는 Ruby on Rails 배포 태스크를 추가해 주는 매우 인기 있는 gem입니다.
\* [mattbrictson/airbrussh](https://github.com/mattbrictson/airbrussh)는 Capistrano의 기본 로그 포맷팅을 제공합니다.
GitHub 이슈는 버그 신고 및 기능 요청을 위한 공간입니다. GitHub 이슈 제출 지침에 대해서는 [CONTRIBUTING](CONTRIBUTING.md) 문서를 참고해 주세요.
Capistrano에서 보안 취약점을 발견했다고 생각되시면 GitHub 이슈를 열지 마세요. 대신 에 신고를 보내주시기 바랍니다.
## 기여하는 방법
코드, 문서 또는 아이디어 형태의 Capistrano 기여는 언제나 환영합니다. Capistrano 코드를 수정하고, 테스트를 실행하며, 첫 번째 pull request를 기여하는 방법을 알아보려면 [DEVELOPMENT](DEVELOPMENT.md) 문서를 읽어보세요.
## 라이선스
MIT License (MIT)
Copyright (c) 2012-2020 Tom Clements, Lee Hambley
본 소프트웨어와 관련 문서 파일("소프트웨어")의 사본을 얻는 모든 사람에게 무료로 권한이 부여되며, 본 소프트웨어를 제한 없이 사용, 복사, 수정, 병합, 배포, Sublicense(재실시) 및/또는 판매할 수 있는 권리를 포함하여 소프트웨어의 사본을 취득할 수 있는 권한이 부여되며, 소프트웨어가 제공되는 사람들은 다음 조건에 따라 이를 허용해야 합니다.
위의 저작권 고지 및본 허용 고지는 소프트웨어의 모든 사본 또는 중요한 부분에 포함되어야 합니다.
본 소프트웨어는 상품성, 특정 목적에의 적합성 및 비침해에 대한 보증을 포함하되 이에 국한되지 않고 명시적이거나 묵시적인 어떠한 보증도 없이 "있는 그대로" 제공됩니다. 어떠한 경우에도 작성자나 저작권자는 계약, 불법행위 또는 기타 사유로 인해 소프트웨어와 관련하여 또는 소프트웨어의 사용 또는 기타 거래로 인해 발생하는 청구, 손해 또는 기타 책임에 대해 어떠한 책임도 지지 않습니다.

capistrano

capistrano 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

capistrano

capistrano 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README