Docker 및 Encore를 사용하여 DigitalOcean에 백엔드 애플리케이션을 배포하는 방법

? 이 가이드에서는 Encore 오픈 소스 CLI의 일부인 새로운 encore 빌드 명령을 사용하여 DigitalOcean에 Encore 애플리케이션을 배포하는 방법을 보여줍니다.

Encore의 Cloud Platform에서 제공하는 자동화보다 수동 배포를 선호하는 경우에 유용합니다.

수동으로 배포하는 경우에도 Encore는 앱을 빌드하고 구성하는 도구를 제공하여 프로세스를 단순화합니다.⚡️

이제 Docker 및 encore 빌드를 사용하여 DigitalOcean의 앱 플랫폼에 Encore 앱을 배포하는 방법을 살펴보겠습니다.

전제조건

• DigitalOcean 계정: DigitalOcean 계정이 있는지 확인하세요. 그렇지 않은 경우 여기에서 가입할 수 있습니다.
• Docker 설치: Docker가 로컬 컴퓨터에 설치되어 있는지 확인하세요. Docker 웹사이트에서 다운로드하실 수 있습니다.
• Encore CLI: Encore CLI를 설치합니다.
  • macOS: Brew 설치 encoredev/tap/encore
  • Linux: 컬 -L https://encore.dev/install.sh | 세게 때리다
  • Windows: iwr https://encore.dev/install.ps1 | 아이엑스
• DigitalOcean CLI(선택 사항): 유연성과 자동화를 높이기 위해 DigitalOcean CLI를 설치할 수 있지만 이 튜토리얼에서는 필요하지 않습니다.

1단계: Encore 앱 만들기

• 새 Encore 앱 만들기:

  • 아직 만들지 않았다면 Encore CLI를 사용하여 새 Encore 앱을 만드세요.
  • 다음 명령을 사용하여 새 앱을 만들 수 있습니다.

  encore app create myapp

  • Hello World 템플릿을 선택하세요.
  • 안내에 따라 앱을 만드세요.

• Docker 이미지 빌드:

  • 배포용 Docker 이미지를 생성하려면 Encore 앱을 빌드하세요.

  encore build docker myapp

2단계: Docker 이미지를 컨테이너 레지스트리에 푸시

Docker 이미지를 DigitalOcean에 배포하려면 이를 컨테이너 레지스트리에 푸시해야 합니다. DigitalOcean이 지원합니다
자체 컨테이너 레지스트리가 있지만 DockerHub 또는 다른 레지스트리를 사용할 수도 있습니다. DigitalOcean의 레지스트리에 이미지를 푸시하는 방법은 다음과 같습니다.

• DigitalOcean 컨테이너 레지스트리 생성:

  • DigitalOcean 제어판으로 이동하여 새 컨테이너 레지스트리를 만듭니다.
  • 지침에 따라 설정하세요.

• DigitalOcean 레지스트리에 로그인:
  
  DigitalOcean에서 제공하는 로그인 명령을 사용하세요.
  
  

doctl registry login

이를 위해서는 DigitalOcean CLI 문서에서 설치할 수 있는 DigitalOcean CLI가 필요합니다.

• Docker 이미지에 태그를 지정하세요: 레지스트리의 URL과 일치하도록 이미지에 태그를 지정하세요.

encore app create myapp

• Docker 이미지를 레지스트리에 푸시:

encore build docker myapp

3단계: DigitalOcean 앱 플랫폼에 Docker 이미지 배포

• 앱 플랫폼으로 이동:
  DigitalOcean의 앱 플랫폼으로 이동하세요.

• 새 앱 만들기:

  • '앱 만들기'를 클릭하세요.
  • "DigitalOcean 컨테이너 레지스트리" 옵션을 선택하세요.

• Docker 이미지 소스 선택:

  • 앞서 푸시한 이미지를 선택하세요.

• 앱 설정 구성:

  • 스케일링 옵션 설정: 컨테이너 수, CPU, 메모리 설정을 구성합니다.
  • 환경 변수: 애플리케이션에 필요할 수 있는 환경 변수를 추가하세요.
  • 지역 선택: 더 나은 성능을 위해 사용자와 가까운 지역을 선택하세요.

• 앱 배포:

  • "다음"을 클릭하고 설정을 검토한 후 "리소스 만들기"를 클릭하세요.
  • DigitalOcean은 인프라 프로비저닝, Docker 이미지 가져오기, 애플리케이션 시작을 담당합니다.

4단계: 앱 모니터링 및 관리

• 애플리케이션 액세스:
  • 배포되면 애플리케이션에 액세스할 수 있는 공개 URL을 받게 됩니다.
  • 앱이 예상대로 실행되는지 테스트합니다.

doctl registry login

• 로그 및 측정항목 보기:

  • 로그를 보려면 앱 플랫폼의 "런타임 로그" 탭으로 이동하세요
  • 성과 지표를 보려면 '통계' 탭으로 이동하세요.

• 확장 및 배포 설정 관리:

  • 확장 설정, 배포 지역, 환경 변수 등 앱 구성을 변경할 수 있습니다.

5단계: 앱에 데이터베이스 추가

DigitalOcean의 앱 플랫폼은 관리형 데이터베이스를 제공하므로 앱에 데이터베이스를 쉽게 추가할 수 있습니다. 앱에 관리형 데이터베이스를 설정하는 방법은 다음과 같습니다.

• DigitalOcean 제어판으로 이동:

  • DigitalOcean 제어판으로 이동하세요.
  • 왼쪽 사이드바에서 "데이터베이스"를 클릭하세요.

• 새 데이터베이스 클러스터 생성:

  • "데이터베이스 클러스터 생성"을 클릭하세요.
  • PostgreSQL을 선택하세요.
  • 데이터베이스 버전, 데이터 센터 지역 및 클러스터 구성(예: 필요에 따른 개발 또는 생산 설정)을 선택합니다.
  • 데이터베이스 이름을 지정하고 필요한 경우 다른 설정을 구성한 다음 "데이터베이스 클러스터 생성"을 클릭하세요.

• 데이터베이스 설정 구성:

  • 데이터베이스가 생성되면 데이터베이스 대시보드의 "연결 세부정보" 탭으로 이동하세요.
  • 연결 문자열 또는 개별 설정(호스트, 포트, 사용자 이름, 비밀번호, 데이터베이스 이름)을 복사합니다. 앱을 데이터베이스에 연결하려면 이러한 세부정보가 필요합니다.
  • CA 인증서 다운로드

• 데이터베이스 생성

  • DigitalOcean에서 제공하는 연결 문자열을 사용하여 데이터베이스에 연결합니다.

encore app create myapp

• 데이터베이스 생성

encore build docker myapp

• Encore 앱에서 데이터베이스 선언:
  • Encore 앱의 코드베이스를 엽니다.
  • 앱에 mydb 데이터베이스 추가(Encore 데이터베이스 설명서)

doctl registry login

• Encore 인프라 구성 만들기
  • Encore 앱의 루트에 infra.config.json이라는 파일을 만듭니다.
  • CA 인증서 및 연결 세부정보를 파일에 추가합니다.

docker tag myapp registry.digitalocean.com/YOUR_REGISTRY_NAME/myapp:latest

• 환경 변수 설정(선택 사항):

  • DigitalOcean 앱 플랫폼 대시보드로 이동하세요.
  • 앱을 선택하세요.
  • "설정" 섹션에서 "앱 수준 환경 변수"로 이동합니다.
  • DB_PASSWORD라는 암호화된 환경 변수로 데이터베이스 비밀번호를 추가합니다.

• Docker 이미지 빌드 및 푸시:

  • 업데이트된 구성으로 Docker 이미지를 빌드합니다.

encore app create myapp

• Docker 이미지에 태그를 지정하고 DigitalOcean 컨테이너 레지스트리에 푸시합니다.

encore build docker myapp

• 데이터베이스 연결 테스트:
  • 변경 사항을 적용하려면 DigitalOcean에 앱을 다시 배포하세요.
  • API를 호출하여 데이터베이스 연결 테스트

doctl registry login

문제 해결 팁

• 배포 실패: 빌드 로그에서 오류를 확인하세요. Docker 이미지가 올바르게 태그 지정되어 레지스트리에 푸시되었는지 확인하세요.
• 앱에 액세스할 수 없음: Dockerfile 및 앱 플랫폼 구성에 올바른 포트가 노출되어 있는지 확인하세요.
• 데이터베이스 연결 문제: 데이터베이스 연결 세부정보가 올바른지, 앱에서 데이터베이스에 액세스할 수 있는지 확인하세요.

결론

그렇습니다! Docker를 사용하여 DigitalOcean의 앱 플랫폼에 Encore 앱을 성공적으로 배포했습니다.

이제 DigitalOcean 대시보드를 통해 앱을 확장하고, 성능을 모니터링하고, 쉽게 관리할 수 있습니다.

? 직접 시도해 보세요

• 이 튜토리얼을 통해 Encore를 사용하여 앱을 구축하는 방법을 알아보세요.
• 오픈 소스 앱 템플릿을 사용하여 무엇을 구축할지 영감을 얻으세요.

마무리

• ⭐️ GitHub에서 Encore를 출연하여 프로젝트를 지원하세요.
• ? 질문이 있거나 작업을 공유하고 싶다면 Discord의 Encore 커뮤니티에 있는 개발자 행아웃에 참여하세요.

위 내용은 Docker 및 Encore를 사용하여 DigitalOcean에 백엔드 애플리케이션을 배포하는 방법의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!