Hızlı Başlangıç: Uygulama yayımlamak için GitHub iş akışı oluşturma

Makale
03/02/2024

Bu hızlı başlangıçta, .NET uygulamanızı kaynak koddan yayımlamak için GitHub iş akışı oluşturmayı öğreneceksiniz. .NET uygulamanızı GitHub'dan bir hedefe otomatik olarak yayımlamak, sürekli dağıtım (CD) olarak adlandırılır. Bir uygulamayı yayımlamak için birçok olası hedef vardır, bu hızlı başlangıçta Azure'da yayımlayacaksınız.

Önkoşullar

Bir GitHub hesabı.
.NET kaynak kodu deposu.
Etkin aboneliği olan bir Azure hesabı. Ücretsiz hesap oluşturun.
bir ASP.NET Core web uygulaması.
Azure Uygulaması Hizmeti kaynağı.

Yayımlama profili ekleme

Uygulamayı Azure'da yayımlamak için uygulamanın App Service örneğinin Azure portalını açın. Kaynağa Genel Bakış bölümünde Yayımlama profilini al'ı seçin ve * öğesini kaydedin. Yerel olarak PublishSetting dosyası.

Uyarı

Yayımlama profili, Azure Uygulaması Hizmeti kaynağınıza erişmek için kimlik bilgileri gibi hassas bilgiler içerir. Bu bilgiler her zaman çok dikkatli bir şekilde ele alınmalıdır.

GitHub deposunda Ayarlar gidin ve sol gezinti menüsünden Gizli Diziler'i seçin. Yeni bir gizli dizi eklemek için Yeni depo gizli dizisi'ni seçin.

Ad olarak girin AZURE_PUBLISH_PROFILE ve yayımlama profilindeki XML içeriğini Değer metin alanına yapıştırın. Add secret (Gizli dizi ekle) öğesini seçin. Daha fazla bilgi için bkz . Şifrelenmiş gizli diziler.

İş akışı dosyası oluşturma

GitHub deposunda,.github/workflows dizinine yeni bir YAML dosyası ekleyin. İş akışının amacını açıkça gösterecek anlamlı bir dosya adı seçin. Daha fazla bilgi için bkz . İş akışı dosyası.

Önemli

GitHub, iş akışı oluşturma dosyalarının .github/workflows dizinine yerleştirilmesini gerektirir.

İş akışı dosyaları genellikle aracılığıyla bir veya daha fazla GitHub Eyleminin bileşimini jobs.<job_id>/steps[*]tanımlar. Daha fazla bilgi için bkz . GitHub Actions için iş akışı söz dizimi.

publish-app.yml adlı yeni bir dosya oluşturun, aşağıdaki YML içeriğini kopyalayıp içine yapıştırın:

name: publish

on:
  push:
    branches: [ production ]

env:
  AZURE_WEBAPP_NAME: DotNetWeb
  AZURE_WEBAPP_PACKAGE_PATH: '.' # Set this to the path to your web app project, defaults to the repository root:
  DOTNET_VERSION: '6.0.401' # The .NET SDK version to use

jobs:
  publish:

    runs-on: ubuntu-latest

    steps:
    - uses: actions/checkout@v3
    - name: Setup .NET Core
      uses: actions/setup-dotnet@v3
      with:
        dotnet-version: ${{ env.DOTNET_VERSION }}

    - name: Install dependencies
      run: dotnet restore
      
    - name: Build
      run: |
        cd DotNet.WebApp
        dotnet build --configuration Release --no-restore
        dotnet publish -c Release -o ../dotnet-webapp -r linux-x64 --self-contained true /p:UseAppHost=true
    - name: Test
      run: |
        cd DotNet.WebApp.Tests
        dotnet test --no-restore --verbosity normal
      
    - uses: azure/webapps-deploy@v2
      name: Deploy
      with:
        app-name: ${{ env.AZURE_WEBAPP_NAME }}
        publish-profile: ${{ secrets.AZURE_PUBLISH_PROFILE }}
        package: '${{ env.AZURE_WEBAPP_PACKAGE_PATH }}/dotnet-webapp'

Önceki iş akışı bileşiminde:

name: publish adı tanımlar, "yayımla" iş akışı durumu rozetlerinde görünür.
```
name: publish
```
Düğüm, on iş akışını tetikleyen olayları gösterir:
```
on:
  push:
    branches: [ production ]
```
- Dalda bir push oluştuğunda production tetiklenen.
Düğüm, env adlandırılmış ortam değişkenlerini (env var) tanımlar.
```
env:
  AZURE_WEBAPP_NAME: DotNetWeb
  AZURE_WEBAPP_PACKAGE_PATH: '.' # Set this to the path to your web app project, defaults to the repository root:
  DOTNET_VERSION: '6.0.401' # The .NET SDK version to use
```
- Ortam değişkenine AZURE_WEBAPP_NAME değeri DotNetWebatanır.
- Ortam değişkenine AZURE_WEBAPP_PACKAGE_PATH değeri '.'atanır.
- Ortam değişkenine DOTNET_VERSION değeri '6.0.401'atanır. Ortam değişkenine daha sonra GitHub Eyleminin dotnet-versionactions/setup-dotnet@v3 belirtilmesi için başvurulur.

Düğüm, jobs iş akışının atılması gereken adımları oluşturur.

jobs:
  publish:

    runs-on: ubuntu-latest

    steps:
    - uses: actions/checkout@v3
    - name: Setup .NET Core
      uses: actions/setup-dotnet@v3
      with:
        dotnet-version: ${{ env.DOTNET_VERSION }}

    - name: Install dependencies
      run: dotnet restore
      
    - name: Build
      run: |
        cd DotNet.WebApp
        dotnet build --configuration Release --no-restore
        dotnet publish -c Release -o ../dotnet-webapp -r linux-x64 --self-contained true /p:UseAppHost=true
    - name: Test
      run: |
        cd DotNet.WebApp.Tests
        dotnet test --no-restore --verbosity normal
      
    - uses: azure/webapps-deploy@v2
      name: Deploy
      with:
        app-name: ${{ env.AZURE_WEBAPP_NAME }}
        publish-profile: ${{ secrets.AZURE_PUBLISH_PROFILE }}
        package: '${{ env.AZURE_WEBAPP_PACKAGE_PATH }}/dotnet-webapp'

Ubuntu'nun en son sürümünde çalıştırılacak adlı publish tek bir iş vardır.
actions/setup-dotnet@v3 GitHub Eylemi, .NET SDK'sını ortam değişkeninden DOTNET_VERSION belirtilen sürümle ayarlamak için kullanılır.
dotnet restore komutu çağrılır.
dotnet build komutu çağrılır.
dotnet publish komutu çağrılır.
dotnet test komutu çağrılır.
azure/webapps-deploy@v2 GitHub Eylemi, uygulamayı verilen publish-profile ve packageile dağıtır.
- publish-profile, depo gizli dizisinden AZURE_PUBLISH_PROFILE atanır.

İş akışı durumu oluşturma rozeti

GitHub depolarının, depo dizininin kökünde bir README.md dosyası olması yaygın bir sıfattır. Benzer şekilde, çeşitli iş akışları için en son durumu bildirmek de güzeldir. Tüm iş akışları, README.md dosyasında görsel olarak çekici olan bir durum rozeti oluşturabilir. İş akışı durumu rozetini eklemek için:

GitHub deposundan Eylemler gezinti seçeneğini belirleyin.
Tüm depo iş akışları sol tarafta görüntülenir, istediğiniz iş akışını ve üç nokta (...) düğmesini seçin.
- Üç nokta (...) düğmesi, seçili iş akışı için menü seçeneklerini genişletir.
Durum oluştur rozet menü seçeneğini belirleyin.
Durumu kopyala rozeti Markdown düğmesini seçin.
Markdown'ı README.md dosyasına yapıştırın, dosyayı kaydedin, işleyin ve değişiklikleri gönderin.