# Сучасні стратегії релізу за допомогою дій GitHub

<!--category-- DevOps, CI/CD, GitHub Actions -->
<datetime class="hidden">2025-12-04T12:00</datetime>

**Найголовніший принцип: МСК0 робить випуск швидшим і безболісним, ",", а ви мСК2 випускаєте частіше** Це є вирішальним для гнучкої розробки. - швидке , надійний запуск створює швидкий зворотній зв 'язок, який ви потребуєте.M SK2 Коли запуск лякає або сповільнює.

Цей інструктор описує стратегії релізу, які я використовую в процесі виробництва: , від простих теги - базових розгортань до мультиплексного МSK2 пакетного монорепо-друку МSK3 Всі приклади з реального [Акція GitHub](https://docs.github.com/en/actions) робочі потоки в цьому базі даних.

[TOC]

## Релізні стратегії на зразок

Перед тим, як зануритися у деталі, ось як порівнювати звичайні стратегії:

| Стратегія
|----------|----------|------------|-----------|
| **Метка-на основі** | ЗастосункиM SK1 експлуатовані випуски МSK2 Низкий МSK3 Стартові компанії , соло-девіси , дорослі команди
| **Розподіл-на основі** | Неперервне розгортання МSK1 Низкий МSK2 Стартування , швидке
| **GitFlow** | Регульовані версії , численні версії МSK2 Високо МSK3 Підприємні M SK4 ConformityM SK5heavy |
| **Trunk-на основі M SK1 Флаги** | високий МSK1 швидкісні команди МSK2 середній | великі технологічні компанії \ , дорослі стартапи \ МSK5
| **Монорепо мульти-пакет** | БібліотекиM SK1 спільної кодові бази МSK2 Середній | Платформані команди, Проекти OSS МSK5

### Що працює, де

**Стартапи & Малі команди**: Почнемо з тегії - базовий або гігантський МSK2 базове розгортання M SK3 Залишаймо це простим - ви завжди можете додавати складність пізніше MSC5 TrunkM SK6 базований розвиток з фразами властивости є популярним в масштабі, але надkill для малих команд

**Підприємство**: Часто вимагає GitFlow або подібного для виконання , аудиторські сліди МSK2 та управління випуском M SK3 Багато об 'єктів середовища МSK4dev, QAMSC6 інсталяціяM SK7 продMska8 з залагодженнями для підтвердження . Зростає потреба в аттестаціях артефактів для безпеки мережі товаропостачання

**Самовиробники**: Метка - базується на ідеальній

**Платформа/Teamи бібліотеки**: Потрібні монорепо-стратегії з незалежною версією кожного пакету . Семантичні версії є вирішальними для потрібних споживачів

## Tag-На основі

Найпростіша і найнадійніша стратегія. Різні префикси теги переміщуються в різні середовища або запускають різні діїM SK1

### Дослідження довкілля

```yaml
on:
  push:
    tags:
      - 'release-*'  # Production
      - 'local-*'    # Dev environment
```

```yaml
- name: Build Docker image
  run: |
    TAG_NAME=${GITHUB_REF#refs/tags/}
    if [[ "$TAG_NAME" == local-* ]]; then
      docker build -t myapp:local .
    else
      docker build -t myapp:latest -t myapp:$(date +%s) .
    fi
```

**Чому це працює?**: Проста модель розуму , експлуатовані запуски МSK2 легкий зворотній зв 'язок за допомогою позначок на timestamped

```bash
# Deploy to production
git tag release-v2024.12.01 && git push origin release-v2024.12.01

# Deploy to dev
git tag local-feature-test && git push origin local-feature-test
```

### Версію пакету

Для монорепо з багатьма пакетами, доступними для публікації, використовуйте префикси теги, щоб визначити, який пакет треба видалити:

```yaml
# Different workflows, different tag patterns
# umami-net.yml
on:
  push:
    tags: ['umamiv*.*.*']  # e.g., umamiv1.0.5

# fetchextension.yml
on:
  push:
    tags: ['fetchextension-v*.*.*']  # e.g., fetchextension-v1.2.0
```

Витягнути версію і використовувати її по всьому світу:

```yaml
- name: Extract version
  run: echo "VERSION=${GITHUB_REF#refs/tags/umamiv}" >> $GITHUB_OUTPUT

- name: Build & Pack
  run: |
    dotnet build -c Release -p:Version=${{ steps.version.outputs.VERSION }}
    dotnet pack -c Release -p:PackageVersion=${{ steps.version.outputs.VERSION }}
```

Для автоматичної версії, [Мінвер](https://github.com/adamralph/minver) обчислює версії з тегов Git:

```xml
<PackageReference Include="MinVer" Version="6.0.0" PrivateAssets="all" />
<PropertyGroup>
  <MinVerTagPrefix>umamiv</MinVerTagPrefix>
</PropertyGroup>
```

## Розподіл на основі

Автоматичний запуск коду, коли він приземляється на певні гілки. Поширений для стартапів та швидкихM SK1 рухомі команди.

```yaml
on:
  push:
    branches: [main]      # → Production
    # branches: [develop] # → Staging
```

**Про**: Ніяких ручних кроків , запускає при поєднанні
**Погані наслідки**: Możliwе випадкове розгортання , менш чітка історія

Я використовую гібридний підхід: - побудувати на гігантському підтримці ( перевірка CI МSK2 але публікувати тільки на ярликах

```yaml
on:
  push:
    tags: ['scheduler-*']
    branches: [main, local]

jobs:
  build:
    # Always build
  publish:
    if: startsWith(github.ref, 'refs/tags/')  # Only publish on tags
```

## Auto-Aktualізації з телевізійною будівлею

Для самопілотних польотів [Вежба](https://containrrr.dev/watchtower/) автоматично витягує нові зображення:

```yaml
services:
  app:
    image: myapp:latest
    labels:
      - "com.centurylinklabs.watchtower.enable=true"

  watchtower:
    image: containrrr/watchtower
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
    command: --interval 300  # Check every 5 minutes
```

**Рівень використання**: Натиснути на значок МSK1 Działaння на GitHub будують МSK2 Натискати до реєстру → Перетягувати телевізійну будівлю

## Квалитеві ворота

Швидкі застосування є непотрібними, якщо ви застосовуєте баги. Кожен робочий процес повинен включати ворота:

```yaml
- name: Run tests
  run: dotnet test --configuration Release

- name: Build
  run: dotnet build --configuration Release

# Tests or build fail → workflow stops → no publish
```

Для багатьох пакетів -フレーмワークу МSK1 збудувати всі цілі МSK2

```yaml
- run: dotnet build -c Release --framework net8.0
- run: dotnet build -c Release --framework net9.0
```

## Публикація без паролів з OIDC

Сучасний підхід - без секретів для обертання , без ключів для витіку МSK2

```yaml
permissions:
  id-token: write
  contents: read

- uses: NuGet/login@v1
  with:
    user: 'myusername'

- run: dotnet nuget push *.nupkg --api-key ${{ steps.login.outputs.NUGET_API_KEY }}
```

GitHub обмінює свій OIDC токен на коротенький

## Безпека мережі постачання

[Виведення артефактів](https://docs.github.com/en/actions/security-for-github-actions/using-artifact-attestations) доводити, що ваші артефакти були збудовані в CI, не підроблені з . Зростає потреба від компаній

```yaml
permissions:
  id-token: write
  attestations: write

- uses: docker/build-push-action@v6
  id: push
  with:
    push: true
    tags: myapp:latest

- uses: actions/attest-build-provenance@v2
  with:
    subject-name: index.docker.io/myuser/myapp
    subject-digest: ${{ steps.push.outputs.digest }}
    push-to-registry: true
```

Споживачі перевіряють за допомогою `gh attestation verify oci://index.docker.io/myuser/myapp:latest --owner myuser`

Це досягає [Уровни SLSA 2](https://slsa.dev/spec/v1.0/levels). Для використання рівня МSK1 [повторювані робочі потоки](https://docs.github.com/en/actions/sharing-automations/reusing-workflows).

## Уявіть собі навколишнє середовище

Командам потрібні зацікавлені сторони, щоб перед слиянням спостерігати за змінами

**Підприємний підхід** - Бюро МSK1посередні об 'єкти переглядуM SK2

```yaml
on:
  pull_request:
    types: [opened, synchronize]

- run: |
    BRANCH=$(echo ${{ github.head_ref }} | sed 's/[^a-zA-Z0-9]/-/g')
    docker build -t myapp:preview-$BRANCH .
    # Deploy to k8s namespace, cloud platform, etc.
```

**Стартування/solo підхід** - Tunel вашої локальної машиниM SK1

```bash
# Cloudflare Tunnel (free)
cloudflared tunnel run --url http://localhost:5000 my-preview
# → https://my-preview.cfargotunnel.com
```

Або використати [Защитник](https://www.wireguard.com/) VPN для внутрішнього командного доступу до вашого dev-аналізатора.

## Практичні поради

**Виczyszczenie ярлики**: Гейт-теги тримаються довкола вічноM SK1

```bash
git tag -d old-test-tag                      # Delete local
git push origin :refs/tags/old-test-tag      # Delete remote
```

**Конвенції про назву**: Будьте послідовнимиM SK1

- `release-YYYY.MM.DD` для виробництва
- `local-feature-name` для dev
- `packagev1.2.3` для бібліотек

**Таємниці**: Поміщайте в [секрети GitHub](https://docs.github.com/en/actions/security-for-github-actions/security-guides/using-secrets-in-github-actions), ніколи не в коді . Як правило, необхідні секрети

- `DOCKER_HUB_ACCESS_TOKEN`
- `NUGET_API_KEY` ( або використовуйте OIDC
- `NPM_TOKEN`

**Розробка монорепо**: Використовувати проектні референції під час розробки , Переключитися на референтації пакетів для перевірки застосування

```xml
<ProjectReference Include="..\MyLib\MyLib.csproj" />
<!-- <PackageReference Include="MyLib" Version="1.0.0" /> -->
```

## Переход до Kubernetes

Те ж саме. МСК0, різні інструменти. МSK1

| Докерний комп 'ютер | Кубerneти МSK2
|----------------|------------|
| Часова куля МSK1 [АргоCD](https://argo-cd.readthedocs.io/) / [Флюкс](https://fluxcd.io/docs/) |
| докер МSK1конструкція МSK2yml середовища | Namespaces \ |
| Перезапуск контейнера | Рольінгування МSK2
| Ручне відхилення | відхиление GitOps МSK2

## Підсумок

1. **Почати з простого**: МеткаM SK1використовування базується на
2. **Додайте складність, коли це потрібно**МСК0 БюроМSK1 базується на МСК2 мультип 'ютерні МСК3 довкілля МSK4 аттестації
3. **Автоматізовані ворота якості**: Тести повинні проходити до публікації
4. **Ввімкнути зворотній поворот**: Тайм-тамповані ярлики або історія GitOps
5. **Безпека вашого трубопроводу**: OIDC для секретів , сертифікати про походження
6. **Порівняйте свій контекст**: Соло-дев МSK1 старт-ап МSK2 бізнес

Тут показані робочі потоки запускаються в цьому базі даних - перевірка `.github/workflows/` для повних застосувань.

**Пам 'ятайте**: Швидкішний , надійні wdrażaння є основою гнучкої розробки МSK2 Вкладіть в свій релізовий канал на ранній стадії