This is a viewer only at the moment see the article on how this works.
To update the preview hit Ctrl-Alt-R (or ⌘-Alt-R on Mac) or Enter to refresh. The Save icon lets you save the markdown file to disk
This is a preview from the server running through my markdig pipeline
Сучасні стратегії релізу за допомогою дій GitHub
Thursday, 04 December 2025
Найголовніший принцип: МСК0 робить випуск швидшим і безболісним, ",", а ви мСК2 випускаєте частіше Це є вирішальним для гнучкої розробки. - швидке , надійний запуск створює швидкий зворотній зв 'язок, який ви потребуєте.M SK2 Коли запуск лякає або сповільнює.
Цей інструктор описує стратегії релізу, які я використовую в процесі виробництва: , від простих теги - базових розгортань до мультиплексного МSK2 пакетного монорепо-друку МSK3 Всі приклади з реального Акція GitHub робочі потоки в цьому базі даних.
Релізні стратегії на зразок
Перед тим, як зануритися у деталі, ось як порівнювати звичайні стратегії:
| Стратегія | ||
|---|---|---|
| Метка-на основі | Застосунки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
Дослідження довкілля
on:
push:
tags:
- 'release-*' # Production
- 'local-*' # Dev environment
- 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
# 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
Версію пакету
Для монорепо з багатьма пакетами, доступними для публікації, використовуйте префикси теги, щоб визначити, який пакет треба видалити:
# 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
Витягнути версію і використовувати її по всьому світу:
- 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 }}
Для автоматичної версії, Мінвер обчислює версії з тегов Git:
<PackageReference Include="MinVer" Version="6.0.0" PrivateAssets="all" />
<PropertyGroup>
<MinVerTagPrefix>umamiv</MinVerTagPrefix>
</PropertyGroup>
Розподіл на основі
Автоматичний запуск коду, коли він приземляється на певні гілки. Поширений для стартапів та швидкихM SK1 рухомі команди.
on:
push:
branches: [main] # → Production
# branches: [develop] # → Staging
Про: Ніяких ручних кроків , запускає при поєднанні Погані наслідки: Możliwе випадкове розгортання , менш чітка історія
Я використовую гібридний підхід: - побудувати на гігантському підтримці ( перевірка CI МSK2 але публікувати тільки на ярликах
on:
push:
tags: ['scheduler-*']
branches: [main, local]
jobs:
build:
# Always build
publish:
if: startsWith(github.ref, 'refs/tags/') # Only publish on tags
Auto-Aktualізації з телевізійною будівлею
Для самопілотних польотів Вежба автоматично витягує нові зображення:
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 Натискати до реєстру → Перетягувати телевізійну будівлю
Квалитеві ворота
Швидкі застосування є непотрібними, якщо ви застосовуєте баги. Кожен робочий процес повинен включати ворота:
- 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
- run: dotnet build -c Release --framework net8.0
- run: dotnet build -c Release --framework net9.0
Публикація без паролів з OIDC
Сучасний підхід - без секретів для обертання , без ключів для витіку МSK2
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 токен на коротенький
Безпека мережі постачання
Виведення артефактів доводити, що ваші артефакти були збудовані в CI, не підроблені з . Зростає потреба від компаній
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. Для використання рівня МSK1 повторювані робочі потоки.
Уявіть собі навколишнє середовище
Командам потрібні зацікавлені сторони, щоб перед слиянням спостерігати за змінами
Підприємний підхід - Бюро МSK1посередні об 'єкти переглядуM SK2
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
# Cloudflare Tunnel (free)
cloudflared tunnel run --url http://localhost:5000 my-preview
# → https://my-preview.cfargotunnel.com
Або використати Защитник VPN для внутрішнього командного доступу до вашого dev-аналізатора.
Практичні поради
Виczyszczenie ярлики: Гейт-теги тримаються довкола вічноM SK1
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для devpackagev1.2.3для бібліотек
Таємниці: Поміщайте в секрети GitHub, ніколи не в коді . Як правило, необхідні секрети
DOCKER_HUB_ACCESS_TOKENNUGET_API_KEY( або використовуйте OIDCNPM_TOKEN
Розробка монорепо: Використовувати проектні референції під час розробки , Переключитися на референтації пакетів для перевірки застосування
<ProjectReference Include="..\MyLib\MyLib.csproj" />
<!-- <PackageReference Include="MyLib" Version="1.0.0" /> -->
Переход до Kubernetes
Те ж саме. МСК0, різні інструменти. МSK1
| Докерний комп 'ютер | Кубerneти МSK2 |
|---|---|
| Часова куля МSK1 АргоCD / Флюкс | |
| докер МSK1конструкція МSK2yml середовища | Namespaces \ |
| Перезапуск контейнера | Рольінгування МSK2 |
| Ручне відхилення | відхиление GitOps МSK2 |
Підсумок
- Почати з простого: МеткаM SK1використовування базується на
- Додайте складність, коли це потрібноМСК0 БюроМSK1 базується на МСК2 мультип 'ютерні МСК3 довкілля МSK4 аттестації
- Автоматізовані ворота якості: Тести повинні проходити до публікації
- Ввімкнути зворотній поворот: Тайм-тамповані ярлики або історія GitOps
- Безпека вашого трубопроводу: OIDC для секретів , сертифікати про походження
- Порівняйте свій контекст: Соло-дев МSK1 старт-ап МSK2 бізнес
Тут показані робочі потоки запускаються в цьому базі даних - перевірка .github/workflows/ для повних застосувань.
Пам 'ятайте: Швидкішний , надійні wdrażaння є основою гнучкої розробки МSK2 Вкладіть в свій релізовий канал на ранній стадії