Azure Geliştirici CLI'sını kullanarak GitHub Actions CI/CD işlem hattı oluşturma

Bu makalede, azd şablonu için GitHub Actions CI/CD işlem hattı oluşturmak üzere Azure Geliştirici CLI'sını (azd) kullanmayı öğreneceksiniz. Bu işlem hattı, şablon güncelleştirmelerini bir kod deposuna göndermenizi ve değişikliklerinizin otomatik olarak sağlanmasını ve Azure ortamınıza dağıtılmanızı sağlar.

Note

Komut azd pipeline config beta sürümündedir. Ayrıntılar için bkz. Özellik sürüm oluşturma ve sürüm stratejisi.

Prerequisites

• Azure Developer CLI'yi yükle
• Visual Studio Code (dosyaları düzenlemek için isteğe bağlı)
• GitHub hesabı
• Azure aboneliği

Şablonu başlatma

Bu örnekte Hello-AZD şablonu kullanılmaktadır, ancak işlem hattı tanım dosyası içeren tüm azd şablonlarda (genellikle veya .github klasörlerinde .azdo bulunur) bu adımları izleyebilirsiniz.

1. Boş bir dizinde hello-azd şablonu başlatın:

   azd init -t hello-azd
   

2. İstendiğinde, ortam için helloazd gibi bir ad girin.

GitHub Actions kullanarak işlem hattı oluşturma

İşlem hattı oluşturmak ve yapılandırmak için şu adımları izleyin:

1. Şablonunuzun kökündeki bir terminalde şunu çalıştırın:

   azd pipeline config
   

2. Sağlayıcı seçmeniz istendiğinde GitHub öğesini seçin.

   ? Select a provider:  [Use arrows to move, type to filter]
   > GitHub
     Azure DevOps
   

3. İstediğiniz Azure aboneliğini ve bölgeyi seçin.

4. Uzak deponuzu yapılandırmanız istendiğinde Yeni bir özel GitHub deposu oluştur öğesini seçin. Kullanmak istediğiniz mevcut bir projeniz varsa Var olan bir GitHub projesi seçin seçeneğini de belirleyebilirsiniz.

   ? How would you like to configure your git remote to GitHub?  [Use arrows to move, type to filter]
     Select an existing GitHub project
   > Create a new private GitHub repository
     Enter a remote URL directly
   

5. Yeni depo için bir ad girin.

6. Yeni bir GitHub Actions çalıştırması başlatmak için yerel değişikliklerinizi işlem yapmanız ve göndermeniz istendiğinde y girin.

7. Terminaldeki çıkışı gözden geçirin. azd pipeline config komutu, projenizin GitHub depo adını görüntüler.

   Note

   Varsayılan olarak, azd pipeline configfederasyon kimlik bilgileri olarak da adlandırılan OpenID Connect'i (OIDC) yapılandırılır. Bunun yerine istemci kimlik bilgilerini kullanmak için komutunu çalıştırın azd pipeline config --auth-type client-credentials.

   Terraform için OIDC/federasyon kimlik bilgileri desteklenmez .

   azd'deki OIDC desteği hakkında daha fazla bilgi edinin.

8. Tarayıcınızda projenizin GitHub deposunu açın.

9. İş akışının çalıştığını görmek için Eylemler'i seçin.

   

İşlem hattını bir kod değişikliğiyle test edin

1. Projenin /src/components/pages dizininde Home.razor dosyasını açın.

2. Dosyanın üst kısmındaki Hello AZD! üst bilgi metnini bulun.

3. Metni Hello, pipeline! olarak değiştirin.

4. Dosyayı kaydedin.

5. Değişikliklerinizi işleme ve gönderme. Bu eylem, güncelleştirmeyi dağıtmak için GitHub Actions işlem hattını tetikler.

   

6. Aşağıdakileri görmek için tarayıcınızda projenizin GitHub deposunu açın:

   • İşlemeniz
   • GitHub Actions kurulumundan işleme

   

7. Test güncelleştirmesinin iş akışına yansıtılmış olduğunu görmek için Eylemler'i seçin.

   

8. Dağıtılan güncelleştirmeyi görüntülemek için çıkışta sağlanan web ön uç URL'sini azd ziyaret edin.

GitHub Eylemi olarak azd kullanma

azd kullanarak GitHub Eylemi olarak yükleyebilirsiniz. Bunu kullanmak için aşağıdakini dosyanıza .github/workflows/azure-dev.yml ekleyin:

on: [push]

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: Install azd
        uses: Azure/setup-azd@v1.0.0

Note

En yeni sürüm numarasını kontrol etmek için setup-azd sürümlerini inceleyin.

Kaynakları temizle

Bu makalede oluşturulan Azure kaynaklarına artık ihtiyacınız kalmadığında aşağıdaki komutu çalıştırın:

azd down

Bu komut, projenizle ilişkili tüm Azure kaynaklarını kaldırır.

Sonraki Adımlar

Azure Developer CLI (azd)