Push Package #1

GitHub Actions kullanarak Docker imajı oluşturma ve ardından GitHub Container Registry (GHCR)’ye (veya benzeri bir container registry'e) pushlama (yayınlama) sürecini gösteriyor.

1) Amaç: Docker İmajını Build Edip GitHub Packages’e Push Etmek

• Neden?

  • Projendeki Docker imajını GitHub’ın container registry’sinde saklayabilir, versiyonlayabilir ve dilediğin yerde kullanabilirsin.

  • Böylece Docker Hub gibi harici servislere bağımlı kalmadan, GitHub platformu içinde CI/CD ve paket yönetimini birleştirirsin.

2) Örnek Workflow Yapısı

on.push.branches: [ 'release' ]

• Bu Workflow, “release” branch’ine yapılan push’larda tetikleniyor.

• Genelde “main” veya “release” branch’lerine commit atınca otomatik Docker imajı build + push yapmak istenebilir.

Ortak “env” Değişkenleri;

env:
  REGISTRY: ghcr.io
  IMAGE_NAME: ${{ github.repository }}

• REGISTRY=ghcr.io: İmajı GHCR’ye atmak istediğini belirtiyor.

• IMAGE_NAME=${{ github.repository }}: Repo adını Docker imajı adı olarak kullanıyor (örnek: owner/repo).

permissions

permissions:
  contents: read
  packages: write

• Docker imajı push edebilmek için “packages: write” izni gerekli.

• GITHUB_TOKEN kullanırken bu permission’ı eklemezsen push işlemi başarısız olur.

3) Adımlar (Steps) İncelemesi

1. Checkout repository

uses: actions/checkout@v4

1. Log in to the Container registry

uses: docker/login-action@<commit-SHA-or-version>
with:
  registry: ${{ env.REGISTRY }}
  username: ${{ github.actor }}
  password: ${{ secrets.GITHUB_TOKEN }}

• docker/login-action ile GHCR (ya da belirttiğin registry) için login yapıyorsun.

• Kullanıcı adı “GitHub aktörü” (workflow’u tetikleyen kullanıcı), şifre olarak da “secrets.GITHUB_TOKEN” kullanılıyor.

• Bu şekilde Docker CLI “login” komutu yapmadan, action kendisi authentication’ı hallediyor.

1. Extract metadata (tags, labels) for Docker

uses: docker/metadata-action@<commit-SHA>
with:
  images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}

• Bu step, Docker imajına eklenecek tag, label gibi bilgileri otomatik oluşturuyor.

• Örneğin commit SHA, sürüm etiketi, vs. Docker imajına eklenebilir.

• Çıktısını (steps.meta.outputs.tags vb.) sonraki adımda kullanıyor.

1. Build and push Docker image

uses: docker/build-push-action@<commit-SHA>
with:
  context: .
  push: true
  tags: ${{ steps.meta.outputs.tags }}
  labels: ${{ steps.meta.outputs.labels }}

• Asıl işi yapan step: Docker imajını build edip GHCR’ye push ediyor.

• context: . → “.” klasöründen Dockerfile alır.

• push: true → Build bittikten sonra registry’ye push etsin.

• tags, labels → Bir önceki “metadata-action” step’inden gelen bilgileri kullanıyor.

Özet

• Bu Workflow, “release” branch’e her push geldiğinde Docker imajı oluşturup GHCR’ye yayınlıyor.

• docker/login-action ile oturum açılıyor, docker/metadata-action ile etiketler ayarlanıyor, docker/build-push-action ile imaj build/push ediliyor.

• Sonuçta projenin Docker imajı GHCR’de saklanmış oluyor, böylece diğer ortamlarda veya sunucularda doğrudan çekilip kullanılabiliyor.