Membuat alur GITHub Actions CI/CD menggunakan Azure Developer CLI

Dalam artikel ini, Anda akan mempelajari cara menggunakan Azure Developer CLI (azd) untuk membuat alur GITHub Actions CI/CD untuk azd templat. Alur ini memungkinkan Anda untuk mendorong pembaruan templat ke repositori kode dan membuat perubahan Anda secara otomatis disediakan dan disebarkan ke lingkungan Azure Anda.

Note

Perintah azd pipeline config dalam versi beta. Untuk detailnya, lihat penentuan versi fitur dan strategi rilis.

Prerequisites

• Menginstal Azure Developer CLI
• Visual Studio Code (opsional, untuk mengedit file)
• Akun GitHub
• Langganan Azure

Menginisialisasi templat

Contoh ini menggunakan templat Hello-AZD , tetapi Anda dapat mengikuti langkah-langkah ini untuk templat apa pun azd yang menyertakan file definisi alur (biasanya ditemukan di .github folder atau .azdo ).

1. Pada direktori yang kosong, inisialisasi templat hello-azd.

   azd init -t hello-azd
   

2. Saat diminta, masukkan nama untuk lingkungan, seperti helloazd.

Membuat alur menggunakan GitHub Actions

Ikuti langkah-langkah ini untuk membuat dan mengonfigurasi alur:

1. Di terminal di akar templat Anda, jalankan:

   azd pipeline config
   

2. Saat diminta untuk memilih penyedia, pilih GitHub.

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

3. Pilih langganan dan wilayah Azure yang Anda inginkan.

4. Saat diminta untuk mengonfigurasi repositori jarak jauh Anda, pilih Buat repositori GitHub privat baru. Jika Anda memiliki proyek yang sudah ada yang ingin Anda gunakan, Anda juga dapat memilih Pilih proyek GitHub yang ada.

   ? 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. Masukkan nama untuk repositori baru.

6. Ketika diminta untuk meng-commit dan push perubahan lokal Anda untuk memulai Tindakan GitHub baru, masukkan y.

7. Tinjau output di terminal. Perintah azd pipeline config menampilkan nama repositori GitHub untuk proyek Anda.

   Note

   Secara default, azd pipeline config mengonfigurasi OpenID Connect (OIDC), juga disebut kredensial terfederasi. Untuk menggunakan kredensial klien sebagai gantinya, jalankan azd pipeline config --auth-type client-credentials.

   Kredensial OIDC/federasi tidak didukung untuk Terraform.

   Pelajari selengkapnya tentang dukungan OIDC di azd.

8. Di browser Anda, buka repositori GitHub untuk proyek Anda.

9. Pilih Tindakan untuk melihat alur kerja berjalan.

   

Menguji alur dengan perubahan kode

1. Di direktori proyek /src/components/pages , buka Home.razor.

2. Hello AZD! Temukan teks header di dekat bagian atas file.

3. Ubah teks menjadi Hello, pipeline!.

4. Simpan file tersebut.

5. Terapkan dan dorong perubahan Anda. Tindakan ini memicu alur GitHub Actions untuk menyebarkan pembaruan.

   

6. Di browser Anda, buka repositori GitHub proyek Anda untuk melihat:

   • Your commit
   • Penerapan dari penyiapan GitHub Actions

   

7. Pilih Tindakan untuk melihat pembaruan pengujian yang tercermin dalam alur kerja.

   

8. Untuk melihat pembaruan yang disebarkan, kunjungi URL frontend web yang disediakan dalam azd output.

Gunakan azd sebagai Tindakan GitHub

Anda dapat menginstal azd sebagai GitHub Action menggunakan tindakan setup-azd. Untuk menggunakannya, tambahkan yang berikut ini ke file Anda .github/workflows/azure-dev.yml :

on: [push]

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

Note

Periksa rilis setup-azd untuk nomor versi terbaru.

Membersihkan sumber daya

Saat Anda tidak lagi memerlukan sumber daya Azure yang dibuat dalam artikel ini, jalankan perintah berikut:

azd down

Perintah ini menghapus semua sumber daya Azure yang terkait dengan proyek Anda.

Next steps

Memantau aplikasi Anda menggunakan Azure Developer CLI (azd)