[우사기] AWS Lightsail 배포 시, GitHub Actions로 환경변수 주입하기

 

 

인프라 구성

 

고정 수입이 없는 상황에서, 인프라 구성 중 가장 큰 고민은 비용이었다. 그래서 AWS의 다양한 서비스 중 가격 대비 성능이 좋은 Lightsail을 선택했고, GitHub Actions를 활용한 CI/CD로 Docker 이미지를 자동 배포하고 있다.

 

 

 

 

GitHub Actions로 환경변수 주입하기

환경변수가 늘어남에 따라 Github Actions workflow를 수정하는 작업이 빈번하게 있어서 해당 내용을 정리해 보고자 한다.

 

 

GitHub Repository Settings
         │
         │ (Secrets 등록)
         │
         ▼
┌──────────────────────────┐
│  GitHub Secrets          │
│  ├─ DEV_DB_URL           │
│  ├─ DEV_DB_PASSWORD      │
│  └─ ...                  │
└──────────┬───────────────┘
           │
           │ ${{ secrets.* }}
           │
           ▼
┌──────────────────────────┐
│  GitHub Actions Runner   │
│  (deploy-dev.yml)        │
│                          │
│  jq -n \                 │
│    --arg db_pass "$..." \│
│    '{                    │
│      environment: {      │
│        DB_PASSWORD: $... │
│      }                   │
│    }'                    │
└──────────┬───────────────┘
           │
           │ deployment.json
           │
           ▼
┌──────────────────────────┐
│  AWS Lightsail           │
│  Container Service       │
│                          │
│  create-container-       │
│  service-deployment      │
└──────────┬───────────────┘
           │
           │ Container ENV
           │
           ▼
┌──────────────────────────┐
│  Spring Boot App         │
│  (Runtime)               │
│                          │
│  ${DEV_DB_URL}           │
│  ${DEV_DB_PASSWORD}      │
└──────────────────────────┘

 

 

 

 

GitHub Repository Settings

 

 

application.yml 파일에 key 값 기준으로 Repository secrests에 환경변수 값을 추가해준다.

 

 

 

 

Github Actions workflow 작성

 

deployment.json 생성

      - name: Create deployment configuration
        run: |
          jq -n \
            --arg db_url "${{ secrets.DEV_DB_URL }}" \
			
            # .. 생략 
            
            '{
              containers: {
                app: {
                  image: $app_image,
                  environment: {
                    KOU_DEV_DB_URL: $db_url,
                    
                    # .. 생략 
                    
                  },
                },

              },

            }' > deployment.json
          
          echo "=== Deployment Configuration ==="
          cat deployment.json

 

deployment.json은 AWS Lightsail Container Service에 어떤 컨테이너를 어떻게 배포할지 정의하는 명세서 역할을 해준다.

문법 오류 없는 JSON 파일을 만들기 위해 jq를 이용했다.

 

 

--arg {변수명} {값}

• arg : jq 내부에서 사용할 변수 선언
• 변수명: jq 내부 변수명 (앞에 `$` 붙여서 사용)
• 값: GitHub Secrets에서 가져온 실제 값

 

{

"environment" : {

      {Key} : ${value}

 }

}

 

• 어떤 환경변수를 주입할지를 작성한다.
• Key : Springboot application.yml에 작성한 값과 동일하게 작성한다.
• value: --arg로 선언한 변수명에 $를 붙여서 작성한다.

 

 

AWS Lightsail 배포

      - name: Deploy to Lightsail
        run: |
          aws lightsail create-container-service-deployment \
            --service-name ${{ env.SERVICE_NAME }} \
            --region ${{ env.AWS_REGION }} \
            --cli-input-json file://deployment.json

 

앞에서 생성한 deployment.json 파일을 AWS Lightsail에 전달하여 실제 배포를 실행한다.

 

 

 

 

 

 

 

🚀 무사히 dev 배포 완료 !