DevOps Bootcamp · 강의

레지스트리에 이미지 푸시

빌드한 Docker 이미지를 Docker Hub 또는 GitHub Container Registry와 같은 컨테이너 레지스트리에 푸시하도록 워크플로를 구성합니다.

레지스트리에 이미지 푸시은(는) CoddyKit의 무료 DevOps Bootcamp 강의입니다. 이것은 4개 중 2번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 DevOps Bootcamp 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. DevOps Bootcamp 강의에는 총 4개의 강의가 포함되어 있습니다.

컨테이너 레지스트리란 무엇인가요?

컨테이너 레지스트리는 도커 이미지를 안전하게 저장하는 온라인 저장 서비스입니다. 애플리케이션 패키지 전용 클라우드 드라이브라고 생각해 보세요.

이미지의 다양한 버전을 저장합니다.
다른 사람과 이미지를 쉽게 공유할 수 있습니다.
다양한 환경에 배포하는 데 필수적입니다.

레지스트리를 사용하는 이유

레지스트리는 현대 소프트웨어 개발에 필수적입니다. 다음과 같은 주요 이점을 제공합니다.

이미지 공유: 애플리케이션 이미지를 쉽게 배포할 수 있습니다.
버전 관리: 애플리케이션의 다양한 버전을 저장하고 관리합니다.
안정적인 배포: 여러 환경에서 일관된 배포를 보장합니다.
보안: 많은 레지스트리가 취약점 검사를 제공합니다.

일반적인 레지스트리 서비스

사용할 수 있는 컨테이너 레지스트리 서비스는 다양합니다. 자주 접하게 될 인기 서비스 두 가지는 다음과 같습니다.

도커 허브: 널리 사용되는 공개 레지스트리입니다. 공개 이미지를 공유하거나 개인 프로젝트를 진행할 때 유용합니다.
GitHub 컨테이너 레지스트리 (GHCR): GitHub 저장소와 긴밀하게 통합됩니다. 비공개 이미지나 이미 GitHub를 사용하는 조직에 적합합니다.

AWS ECR이나 구글 컨테이너 레지스트리처럼 주요 클라우드 제공업체도 자체 레지스트리를 제공합니다.

레지스트리 인증

레지스트리에 이미지를 푸시하기 전에 본인임을 증명해야 합니다. 이 과정을 인증 또는 '로그인'이라고 합니다.

일반적으로 사용자 이름과 개인 액세스 토큰(PAT) 또는 비밀번호를 제공합니다. 이러한 자격 증명을 사용하면 인증된 사용자만 비공개 저장소에서 이미지를 푸시하거나 가져올 수 있습니다.

로그인 작업 사용

GitHub 작업에서 대부분의 도커 호환 레지스트리에 인증하는 가장 좋은 방법은 docker/login-action을 사용하는 것입니다.

이 작업은 지정된 레지스트리에 워크플로를 안전하게 로그인시키므로 이후 단계에서 이미지를 푸시할 수 있습니다. 이 작업은 username과 password를 입력값으로 받습니다.

도커 허브로 푸시하기

도커 허브로 이미지를 푸시하려면 워크플로에서 다음을 수행해야 합니다.

로그인: GitHub 비밀로 저장한 도커 허브 사용자 이름과 개인 액세스 토큰(PAT)을 사용해 docker/login-action으로 로그인합니다.
빌드 및 푸시: docker/build-push-action을 사용해 이미지를 빌드하고 push: true로 설정합니다. 이미지 태그에 도커 허브 사용자 이름이 포함되어야 합니다(예: your_username/my-app:latest).

도커 허브 워크플로 예시

다음은 도커 허브로 도커 이미지를 빌드하고 푸시하는 GitHub 작업 워크플로 예시입니다. 저장소에서 DOCKER_USERNAME 및 DOCKER_TOKEN을 GitHub 비밀로 설정해야 합니다.

name: Publish Docker image to Docker Hub

on:
  push:
    branches: [ "main" ]

jobs:
  build-and-push:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout repository
        uses: actions/checkout@v4

      - name: Log in to Docker Hub
        uses: docker/login-action@v3
        with:
          username: ${{ secrets.DOCKER_USERNAME }}
          password: ${{ secrets.DOCKER_TOKEN }}

      - name: Build and push Docker image
        uses: docker/build-push-action@v5
        with:
          context: .
          push: true
          tags: ${{ secrets.DOCKER_USERNAME }}/my-app:latest

GHCR로 푸시하기

GHCR은 원활한 통합을 제공합니다. GHCR의 주요 차이점은 다음과 같습니다.

인증: 기본 제공되는 GITHUB_TOKEN을 인증에 사용할 수 있습니다. username: ${{ github.actor }} 및 password: ${{ secrets.GITHUB_TOKEN }}으로 설정합니다.
권한: 작업에 packages: write 권한이 필요합니다.
이미지 태그 지정: 이미지 태그는 ghcr.io/<OWNER>/<REPOSITORY>:<TAG>와 같은 형식으로 지정합니다.

GHCR 워크플로 예시

이 워크플로는 GitHub 컨테이너 레지스트리에 이미지를 푸시하는 방법을 보여 줍니다. permissions 블록과 이미지 태그 형식에 유의하세요.

name: Publish Docker image to GHCR

on:
  push:
    branches: [ "main" ]

jobs:
  build-and-push:
    runs-on: ubuntu-latest
    permissions:
      contents: read
      packages: write # Required for GHCR

    steps:
      - name: Checkout repository
        uses: actions/checkout@v4

      - name: Log in to GHCR
        uses: docker/login-action@v3
        with:
          registry: ghcr.io
          username: ${{ github.actor }}
          password: ${{ secrets.GITHUB_TOKEN }}

      - name: Build and push Docker image
        uses: docker/build-push-action@v5
        with:
          context: .
          push: true
          tags: ghcr.io/${{ github.repository }}:latest

이해도 확인

컨테이너 레지스트리에 이미지를 푸시하는 방법을 배운 내용을 간단히 복습해 보겠습니다.

복습: 이미지 푸시하기

잘하셨습니다! GitHub Actions를 사용하여 Docker 이미지를 컨테이너 레지스트리에 푸시하는 방법을 학습하셨습니다.

컨테이너 레지스트리는 Docker 이미지를 저장하고 관리합니다.
자격 증명을 사용한 인증은 중요한 첫 단계입니다.
docker/login-action을 사용하면 안전하게 로그인할 수 있습니다.
Docker Hub와 GitHub Container Registry의 예제를 모두 살펴보면서 각각의 인증 및 태그 지정 요구 사항을 이해하셨습니다.

다음에는 이 이미지를 Kubernetes에 배포하는 방법을 학습하겠습니다!

자주 묻는 질문

“레지스트리에 이미지 푸시” 강의는 무료인가요?

네 — “레지스트리에 이미지 푸시” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 DevOps Bootcamp 강의 전체를 잠금 해제할 수 있습니다. DevOps Bootcamp 강의에는 총 4개의 강의가 포함되어 있습니다.

“레지스트리에 이미지 푸시”에서 뭘 배우나요?

빌드한 Docker 이미지를 Docker Hub 또는 GitHub Container Registry와 같은 컨테이너 레지스트리에 푸시하도록 워크플로를 구성합니다. 브라우저에서 직접 실행하는 실습 코드로 DevOps Bootcamp을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

DevOps Bootcamp을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 DevOps Bootcamp은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 2번째 강의입니다.

“레지스트리에 이미지 푸시” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 DevOps Bootcamp 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 DevOps Bootcamp 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

← DevOps Bootcamp(으)로 돌아가기