# 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;

```yaml
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

```yaml
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. **C**heckout repository

```yaml
uses: actions/checkout@v4
```

2. Log in to the Container registry

```yaml
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.

3. Extract metadata (tags, labels) for Docker

```yaml
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.

4. Build and push Docker image

```yaml
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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://note.onurbolatoglu.com/github-actions/push-package-1.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.