배포 시 자동으로 생성된 GitHub Actions workflow를 활용해 배포 자동화 파이프라인을 간편하게 구성할 수 있습니다.

시크릿 설정
Porter AI의 앱 배포 플랫폼과 GitHub의 통신을 위한 시크릿 설정이 필요합니다.
GitHub Personal access token 발급
GitHub Personal access token 발급

GitHub 계정 Settings의 Developer settings 화면에서 Personal access tokens 메뉴의 Generate new token(classic)을 클릭하세요.

이어지는 화면에서repo,admin:public_key권한을 부여하고 토큰을 생성하세요.

생성된 토큰값을 보관하세요.
Porter AI의 API Key 발급
Porter AI의 API Key 발급

스페이스 설정화면의 인증 메뉴에서 새로운 API 키 생성을 클릭해 키를 생성하고 보관하세요.
위의 시크릿을 GitHub 저장소의 Actions Secret으로 설정
위의 시크릿을 GitHub 저장소의 Actions Secret으로 설정

GitHub 저장소의 Settings화면 Secrets and variables의 Actions항목에서 New repository secret을 클릭하세요.

Name값에 주의하며 2개의 Repository secret을 생성하세요.
GitHub Actions 적용
Workflow 파일 내용 조회

Github Actions를 적용하려는 서비스 상세페이지의 CLI탭에서 Github Actions 항목의 코드를 복사하세요.
endpoint는
Porter AI가 설치된 환경에 따라 자동으로 변경됩니다.Workflow 파일 생성
프로젝트의 루트 디렉토리에 .github/workflows 디렉토리를 생성하고 복사한 코드를 내용으로 하는 yaml 파일을 만들어주세요.
.github/workflows폴더는 약속된 경로이기 때문에 변경할 수 없지만 파일명은 자유롭게 설정할 수 있습니다.
액션 별 입력값
GitHub Actions는 앱 배포 플랫폼에서 저장소를 Pull 할 수 있도록 GitHub 저장소 Deploy Key 를 설정하는 connect 액션과 배포 설정을 앱 배포 플랫폼에 전송하고 배포를 요청하는 deploy 액션으로 작동합니다
connect 액션 입력값
connect 액션 입력값
deploy 액션 입력값
deploy 액션 입력값
활용
자동으로 생성된 workflow 파일을 서비스 설정에 맞게 수정해서 활용할 수 있습니다.
서브 디렉토리 설정
서브 디렉토리 설정
path에 배포할 디렉토리를 설정할 수 있습니다.
리소스 쿼터 변경
리소스 쿼터 변경
yaml 파일에 리소스에 관한 내용이 없는 경우, 대시보드에서 설정한 리소스 쿼터를 반영합니다. yaml 파일로 리소스를 관리하려는 경우 resources에spot,cpu,memory,disk,replicas를 설정해 적용할 수 있습니다.
환경 변수 설정
환경 변수 설정
대시보드에서 환경 변수를 설정해서 배포한 경우, CLI탭의 workflow 파일 내용에 자동으로 반영됩니다. yaml 파일에 수동으로 적용하려는 경우 options.env 에 name과 value를 배열 형태로 설정해 적용할 수 있습니다.
서비스 대상 포트
서비스 대상 포트
options.ports 에서 콤마(,)로 포트를 구분하여 총 3개의 포트까지 설정 가능합니다.