CI/CD 구축 - no basic auth credentials 에러 해결

준하·2025년 1월 21일

도커 컨테이너 기반의 프로젝트에서 CI/CD 적용하면서 겪은 과정을 정리하려고 한다.

CI/CD 과정

.github/workflows/deploy.yml

name: Deploy To EC2

on:
  push:
    branches:
      - main
      - dev

jobs:
  deploy:
    runs-on: ubuntu-latest
    env:
      APP_NAME: liveblog-server
    steps:
      - name: Github Repository 파일 불러오기
        uses: actions/checkout@v4

      - name: JDK 17버전 설치
        uses: actions/setup-java@v4
        with:
          distribution: temurin
          java-version: 17

      - name: application.yml 파일 만들기
        run: echo "${{ secrets.APPLICATION_PROPERTIES }}" > ./src/main/resources/application.yml

      - name: 테스트 및 빌드하기
        run: ./gradlew clean build

      - name: AWS Resource에 접근할 수 있게 AWS credentials 설정
        uses: aws-actions/configure-aws-credentials@v4
        with:
          aws-region: ap-northeast-2
          aws-access-key-id: ${{ secrets.AWS_ACCESS_KEY_ID }}
          aws-secret-access-key: ${{ secrets.AWS_SECRET_ACCESS_KEY }}

      - name: ECR에 로그인하기
        id: login-ecr
        uses: aws-actions/amazon-ecr-login@v2

      - name: Docker 이미지 생성
        run: docker build -t $APP_NAME .

      - name: Docker 이미지에 Tag 붙이기
        run: docker tag $APP_NAME ${{ steps.login-ecr.outputs.registry }}/$APP_NAME:latest

      - name: ECR에 Docker 이미지 Push하기
        run: docker push ${{ steps.login-ecr.outputs.registry }}/$APP_NAME:latest

      - name: SSH로 EC2에 접속하기
        uses: appleboy/ssh-action@v1.0.3
        with:
          host: ${{ secrets.EC2_HOST }}
          username: ${{ secrets.EC2_USERNAME }}
          key: ${{ secrets.EC2_PRIVATE_KEY }}
          script_stop: true
          script: |
            APP_NAME=${{ env.APP_NAME }}
            docker stop $APP_NAME || true
            docker rm $APP_NAME || true
            docker pull ${{ steps.login-ecr.outputs.registry }}/$APP_NAME:latest
            docker run -d --name $APP_NAME -p 80:8080 ${{ steps.login-ecr.outputs.registry }}/$APP_NAME:latest

대략적인 Flow는 다음과 같다.

Git Push
application.yml 파일을 GitHub Secrets에서 복사한다.
Docker 이미지를 생성한다. (docker build -t .)
- 프로젝트 디렉토리 하위에 Dockerfile을 정의.
ECR에 Docker 이미지를 push
SSH로 EC2 접속, ECR에서 도커 이미지를 다운 후 동작

빌드 과정에서 application.yml을 GitHub Secrets에 저장한 후 복사해 사용하는 방식은 민감한 정보를 코드베이스에 노출하지 않아 보안을 강화할 수 있다.

에러 발생

SSH로 EC2 접속하기 부분에서
no basic auth credentials 에러가 지속적으로 발생하면서 실패하였다.

결과적으로 아래 3번 권한 설정이 누락되어 발생한 문제임을 깨닫고 해결하였다.

권한 설정

위 flow가 성공하려면 세가지 권한 설정이 필요하다.

Github Actions가 AWS ECR에 접근 가능해야한다. (이미지 푸시)
Github Actions가 EC2 인스턴스에 접근 가능해야한다. (SSH 접속)
EC2 인스턴스가 AWS ECR에 접근 가능해야한다. (이미지 다운)

3의 권한 설정이 필요한 이유는 ECR의 Private Repository에 이미지를 저장하는 방식을 선택했기 때문이다.

1. Github Actions -> AWS ECR

Github Actions가 내 AWS Resource에 접근하려면
적절하게 권한이 설정된 IAM 유저의 Access Key와 Secret Access Key가 필요하다.

Access Key는 유저를 식별하는 ID, Secret Access Key는 Password 같은 개념이다.

이를 위해 CI-CD 라는 이름의 User Group을 만들고, IAM User 하나를 생성해 연결하였다.

CI-CD 유저 그룹에는 AmazonEC2ContainerRegistryFullAccess(ECR) 정책을 설정한다.

name: AWS Resource에 접근할 수 있게 AWS credentials 설정
uses: aws-actions/configure-aws-credentials@v4
with:
	aws-region: ap-northeast-2
	aws-access-key-id: ${{ secrets.AWS_ACCESS_KEY_ID }}
	aws-secret-access-key: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
    
name: ECR에 로그인하기
id: login-ecr
uses: aws-actions/amazon-ecr-login@v2