2단계. 이미지 레지스트리 푸시¶

직접 빌드한 Docker 이미지를 Gitea 컨테이너 레지스트리에 푸시합니다.

사전 준비¶

Docker Desktop 설치 및 실행 확인 (다운로드)
Make 설치 확인 (macOS는 기본 설치됨)
```
make --version
```
Gitea 계정 및 레지스트리 접근 권한

1. Gitea 레지스트리 로그인¶

액세스 토큰 생성¶

Docker 로그인 시 계정 비밀번호 대신 액세스 토큰을 사용합니다. 토큰은 최초 1회 생성 후 별도로 저장해 두어야 합니다.

Gitea 우측 상단 프로필 클릭 > 설정 이동
좌측 메뉴에서 어플리케이션 선택
액세스 토큰 이름 입력 (임의)
권한 항목에서 repository를 Read and Write로 변경
토큰 생성 버튼 클릭
생성된 토큰 문자열을 복사하여 별도 저장

토큰 저장 필수

토큰은 생성 직후에만 확인할 수 있습니다. 창을 닫으면 다시 볼 수 없으므로 반드시 저장해 두세요.

로그인¶

docker login <GITEA_HOST>
# 예: docker login gitea.{베이스 도메인}

Username: Gitea 계정 아이디
Password: 위에서 생성한 액세스 토큰

로그인 성공 시 Login Succeeded 메시지가 표시됩니다.

2. Makefile 설정 확인¶

빌드 전 Makefile의 아래 두 항목을 확인하고 필요 시 수정합니다.

IMAGE_TAG   := <IMAGE_TAG>          # 예: 1.0.0
GITEA_IMAGE := <GITEA_HOST>/<PROJECT_ID>/<REPO>
                                    # 예: gitea.{베이스 도메인}/my-project/my-app
                                    # <PROJECT_ID>: Runway 프로젝트 ID (= 네임스페이스)
                                    # <REPO>: Gitea에서 생성한 저장소 이름

3. 이미지 빌드 및 푸시¶

make docker-build-push-gitea

4. 푸시 확인¶

푸시된 이미지는 Gitea 저장소의 Packages 탭에서 확인할 수 있습니다.

https://<GITEA_HOST>/<PROJECT_ID>/<REPO>/packages

이미지 상세 페이지에서 pull 명령어, Digest, 아키텍처 정보를 확인할 수 있습니다.

5. 패키지를 레포지토리에 연결하기¶

Gitea에 푸시된 이미지는 기본적으로 조직 또는 계정의 Packages 페이지에만 표시됩니다. 특정 레포지토리와 연결하려면:

Packages 페이지에서 연결할 이미지 클릭
이미지 상세 페이지 우측 패널 > 설정 클릭
Link this package to a repository 항목에서 연결할 레포지토리 선택