Hızlı Başlangıç: Uygulama yayımlamak için GitHub iş akışı oluşturma
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ğundaproduction
tetiklenen.
- Dalda bir
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ğeriDotNetWeb
atanı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 Eyleminindotnet-version
actions/setup-dotnet@v3
belirtilmesi için başvurulur.
- Ortam değişkenine
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şkenindenDOTNET_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ı verilenpublish-profile
vepackage
ile dağıtır.publish-profile
, depo gizli dizisindenAZURE_PUBLISH_PROFILE
atanır.
- Ubuntu'nun en son sürümünde çalıştırılacak adlı
İş 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.
Daha fazla bilgi için bkz . İş akışı durumu ekleme rozeti.
Örnek yayımlama iş akışı durumu rozeti
Geçir -erek | Başarısız | Durum yok |
---|---|---|