이 기사에서는 Ruby on Rails 애플리케이션에서 Capistrano를 구성합니다. 그런 다음 호스팅 공급자와 관계없이 Ubuntu를 운영 체제로 실행하는 클라우드 인스턴스에 앱을 배포합니다. 어떤 클라우드 서비스나 온프레미스 서버를 사용하여 우리가 취할 단계를 테스트하거나 복제할 수 있습니다.
앱을 배포한 후에는 AppSignal을 사용하여 앱 배포를 모니터링할 수 있는 방법을 간략하게 살펴보겠습니다.
하지만 먼저 다음과 같은 질문을 하실 수도 있습니다:애초에 왜 Capistrano를 사용해야 합니까?
Ruby on Rails 앱에 Capistrano를 선택하는 이유는 무엇인가요?
요즘 배포에 Capistrano를 계속 사용하는 것이 여전히 타당한지 궁금할 것입니다. 이제 배포 및 지속적인 통합에 사용할 수 있는 다양한 도구와 서비스가 있습니다.
하지만 이에 답하기 위해서는 Capistrano의 기원과 그것이 오늘날까지 진화한 과정을 다시 살펴볼 필요가 있습니다. Capistrano 저장소에 생성된 첫 번째 태그는 2006년이었습니다. 그 목적은 모두 DSL을 사용하는 여러 시스템에서 SSH를 통해 원격으로 명령을 병렬로 실행할 수 있도록 하는 것이었습니다. 그 이후로 Capistrano는 각 버전에 여러 기능을 추가하여 발전했습니다.
현재 16년이 지난 버전 3에서 Capistrano는 계속해서 활발하게 개발되고 있으며 현재는 자동화된 배포 스크립트를 구축하기 위한 프레임워크로 알려져 있습니다.
따라서 더 이상 원격 시스템에서 명령을 실행하는 도구가 아닙니다. Capistrano의 기능 외에도 많은 플러그인과 기타 보석이 Capistrano와 함께 실행됩니다.
이 점과 대규모 커뮤니티에서 여전히 Capistrano를 사용하고 있다는 사실 때문에 Capistrano는 자동화된 배포를 위한 훌륭한 도구로 남아 있습니다.
Ruby on Rails 앱에 Capistrano 추가
먼저 Ruby on Rails 애플리케이션을 Capistrano와 통합하도록 구성해야 합니다. Capistrano의 문서를 따라갈 수 있습니다. 하지만 이 게시물의 범위에 필요한 것보다 더 많은 정보가 포함되어 있습니다. 따라서 단순화를 위해 이 문서에는 필요한 단계와 구성만 포함되어 있습니다.
구성을 시작하려면 Gemfile의 개발 섹션에 Capistrano gem을 추가하세요:
데이터베이스에서 마이그레이션을 실행하고 다음 섹션에서 볼 자산을 처리하려면 capistrano-rails gem이 필요합니다.
이제 bundle install을 실행하세요. 애플리케이션에 Capistrano를 추가하려면:
그런 다음 Capistrano를 설치할 수 있습니다:
이 명령은 Capfile라는 파일을 생성합니다. 필요한 라이브러리를 가져오고 구성합니다. 또한 deploy.rb라는 파일이 있습니다. (config 내부에서 생성됨) 폴더)에는 Capistrano 배포에 포함되어야 하는 모든 구성이 포함됩니다.
참고: Capistrano는 deploy.rb를 재정의하는 파일을 생성합니다. 스테이징 및 프로덕션 환경 모두에 대한 구성이 있지만 이 문서에서는 다루지 않습니다.
이제 Ruby on Rails 애플리케이션과 서버 간의 구성 및 통신을 시작할 준비가 되었습니다.
Rails 앱을 위한 Capistrano를 사용한 서버 구성
이 단계에서는 Capistrano 구성 파일에 지침을 추가합니다. 지침은 앱이 배포될 서버에 전달됩니다. 여기에서 액세스 정보와 보안 구성을 정의합니다.
프로덕션 환경에서 개발에 사용하는 버전과 동일한 Ruby 버전을 실행하려면 RVM과 같은 Ruby 버전 관리자를 사용하세요. 또는 rbenv (Capistrano는 둘 다 지원합니다).
이번 글에서는 RVM을 사용하겠습니다. 개발 머신과 프로덕션 서버에 RVM이 설치되어 있는지 확인하세요. 또한, 귀하의 환경과 프로젝트에서 Ruby 버전이 동일한지 확인하세요.
capistrano-rvm 추가 보석
Capistrano 프로젝트는 capistrano-gem이라는 gem을 제공합니다. 이를 통해 RVM을 쉽게 구성할 수 있습니다. 프로젝트에 포함하려면 개발 그룹 내의 Gemfile에 추가하고 bundle install를 실행하세요. 또.
capistrano-rvm 가져오기로 Capfile을 업데이트하세요:
배포 파일에서 Ruby 버전과 RVM 경로를 설정하는 구성을 추가합니다(특히 RVM을 설치하기 위해 다른 경로를 사용한 경우).
정의된 Ruby 버전이 없으면 Capistrano는 애플리케이션이 배포될 서버에 설치된 최신 버전을 선택합니다.
Capistrano::RVM에는 RVM에 대한 다른 설정이 있지만 시작하려면 여기에 표시된 설정이 필요합니다.
서버 구성 설정
배포할 사용자를 정의하는 것이 좋습니다. 배포를 시작하기 전에 서버에서 다음 단계를 수행하는 것을 잊지 마십시오:
- 로컬 시스템에서 생성된 공개 키를
~/home/YOUR_USER/.ssh/authorized_keys에 추가하세요. 파일. - 키를 생성하고 코드 저장소에 공개 키를 포함합니다. 이를 통해 프로덕션 서버 내에서 프로젝트를 복제할 수 있는 액세스 권한이 제공됩니다. GitHub를 사용하는 경우 이 문서를 따르세요.
/var/www/에 쓰기 권한을 설정합니다. 디렉토리.
필요한 모든 환경에 맞게 Capistrano를 구성할 수 있습니다. config/deploy/<environment_name>.rb 안에 새 구성 파일을 생성하기만 하면 됩니다. 을 누른 다음 IP 또는 DNS, 사용자 이름을 구성하여 서버에 연결하세요.
배포 설정을 완료하려면 애플리케이션 이름, 코드 저장소 URL 등 애플리케이션에 대한 정보를 포함하세요. 모든 환경에 대해 동일한 정보는 config/deploy.rb에 추가되어야 합니다. . config/deploy/<environment_name>.rb에 특정 환경 구성을 유지합니다. .
capistrano-secrets-yml 설정 Rails 앱을 위한 보석
capistrano-secrets-yml gem도 설정해야 합니다.
Gemfile에 gem을 추가하고 번들을 실행하여 설치하세요:
Capfile로 가져오기:
그런 다음 config/secret.yml를 생성하세요. 애플리케이션에 비밀 키 기반을 환경 변수로 포함합니다. 이 변수는 프로덕션 서버에 생성됩니다. 기억하지 않음 이 파일을 저장소에 커밋하세요.
터미널의 애플리케이션 폴더 내에서 다음 명령을 실행하여 비밀 키 베이스를 생성하세요.
생성된 키를 복사하고 이를 사용하여 프로덕션 서버에서 SECRET_KEY_BASE를 설정합니다. 프로덕션 서버에 액세스하고 최종 ~/.bashrc에서 SECRET_KEY_BASE 변수를 내보냅니다. 파일이므로 항상 사용할 수 있습니다.
소스를 실행하여 환경에서 즉시 사용할 수 있도록 하세요:
이제 컴퓨터로 돌아가서 터미널의 애플리케이션 폴더에 액세스하고 아래 Capistrano 명령을 실행하여 config/secrets.yml을 만듭니다. 프로덕션 서버에서:
모두 완료되었습니다! 이제 마이그레이션을 실행하도록 Capistrano를 구성할 차례입니다.
데이터베이스 마이그레이션을 수행하도록 Capistrano 구성
이제 데이터베이스 관련 명령을 실행하도록 Capistrano를 구성할 차례입니다.
capistrano 레일 Gemfile에 이미 포함된 gem은 각 배포에서 마이그레이션을 수행하도록 구성할 수 있습니다. Capfile로 가져오기만 하면 됩니다:
하지만 배포 시 시드를 실행하려면 마이그레이션 후에 실행할 새 작업을 만들어야 합니다.
이로써 마침내 앱을 배포할 준비가 되었습니다!
Ruby on Rails 앱 배포 시작
서버를 애플리케이션의 새 버전으로 직접 업데이트하여 로컬 시스템에서 배포를 수행하는 방법을 살펴보겠습니다.
배포 명령을 실행하면 Capistrano가 서버에 연결됩니다. 거기에서 Capistrano는 구성 파일(config/deploy.rb)에 정의된 저장소에서 코드 복제를 시도합니다. ). 그런 다음 배포 흐름에 따라 다른 작업이 수행됩니다.
Capistrano의 deploy:check 명령은 Git 구성이 양호하고 Capistrano가 배포에 사용될 디렉터리에 대한 올바른 액세스 권한을 가지고 있는지 확인합니다.
그것을 사용하려면 환경을 전달하십시오. 이 경우에는 프로덕션을 사용합니다:
구성에 문제가 없으면 프로덕션 배포를 시작할 수 있습니다.
또한 다음 명령을 사용하여 Capistrano에서 사용 가능한 모든 작업을 확인할 수 있습니다:
이제 마지막 단계에서는 Ruby on Rails 애플리케이션을 AppSignal과 통합하고 모니터링을 시작하겠습니다.
AppSignal을 Capistrano 및 Rails 앱과 통합하는 방법
AppSignal은 모니터링 도구이므로 이 기사에 포함된 이유가 궁금할 것입니다. 모니터링은 배포와 직접적인 관련이 없으므로 이는 유효한 질문입니다.
즉, AppSignal은 Ruby on Rails 애플리케이션을 모니터링하고 각 환경의 배포를 추적하는 데 유용한 도구입니다. 이제 앱에 AppSignal을 설정하는 방법을 살펴보겠습니다.
AppSignal의 가입 페이지에서 생성할 수 있는 AppSignal 계정이 필요합니다. 언어로 Ruby를 선택하고 단계에 따라 애플리케이션에 AppSignal을 설치하세요.
설치되면 AppSignal을 구성하기 위한 파일이 생성됩니다. 여기서 중요한 것은 개정을 정의하는 것입니다. — 새 버전의 애플리케이션이 배포되었는지 확인하기 위해 배포 후 확인되는 정보입니다. 이 경우 Git 로그를 개정 정보로 사용하여 각각의 새로운 코드 배포가 AppSignal에 알릴 수 있도록 합니다.
AppSignal 환경 변수를 프로덕션 서버로 내보내는 것도 좋은 습관입니다(특히 API 키를 AppSignal 구성 파일에 보관하지 않도록).
이제 배포를 다시 실행할 수 있습니다. 모든 것이 올바르게 설정되면 배포가 끝날 때 다음과 같은 메시지가 표시됩니다:
이제 AppSignal에서 애플리케이션을 볼 수 있습니다! 🎉
배포에 관한 정보:
Ruby on Rails 애플리케이션에 사용할 수 있는 배포 통합 및 기타 기능에 대해 자세히 알아보려면 AppSignal의 배포 설명서 페이지를 방문하세요.
마무리 및 다음 단계
이 게시물에서는 Capistrano를 사용하여 Ruby on Rails 앱을 배포하는 방법을 살펴보았습니다. 먼저 Capistrano를 앱에 추가한 다음 이를 구성하고 배포한 후 마지막으로 AppSignal로 모니터링을 설정했습니다.
더 자세히 살펴보고 싶다면 저장소의 파이프라인에 연결된 통합에서 실행되도록 Capistrano를 구성할 수 있습니다. Bitbucket, GitHub, GitLab과 같은 도구는 이 프로세스를 관리하기 위한 설정을 제공하며 Capistrano와 함께 사용할 수 있습니다.
즐거운 코딩 되세요!
추신 Ruby Magic 게시물이 보도되는 즉시 읽으려면 Ruby Magic 뉴스레터를 구독하고 단 하나의 게시물도 놓치지 마세요!