Penyebaran Berkelanjutan dengan Azure DevOps

  • Artikel

Penting

Perintah Kustom akan dihentikan pada 30 April 2026. Mulai 30 Oktober 2023 Anda tidak dapat membuat aplikasi Perintah Kustom baru di Speech Studio. Terkait perubahan ini, LUIS akan dihentikan pada 1 Oktober 2025. Mulai 1 April 2023 Anda tidak dapat membuat sumber daya LUIS baru.

Dalam artikel ini, Anda mempelajari cara menyiapkan penyebaran berkelanjutan untuk aplikasi Perintah Kustom Anda. Skrip untuk mendukung alur kerja CI/CD disediakan untuk Anda.

Prasyarat

  • Aplikasi Perintah Kustom untuk pengembangan (DEV)
  • Aplikasi Perintah Kustom untuk produksi (PROD)
  • Daftar ke Alur Azure

Ekspor/Impor/Terbitkan

Skrip dihosting di Asisten Suara - Perintah Kustom. Kloning skrip di direktori bash ke repositori Anda. Pastikan Anda mempertahankan jalur yang sama.

Menyiapkan alur

  1. Buka Azure DevOps - Alur dan pilih "Alur Baru"

  2. Di bagian Hubungkan, pilih lokasi repositori tempat skrip ini berada

  3. Di bagian Pilih, pilih repositori Anda

  4. Di bagian Konfigurasi, pilih "Alur awal"

  5. Selanjutnya Anda mendapatkan editor dengan file YAML, ganti bagian "langkah" dengan skrip ini.

    steps:
- task: Bash@3
  displayName: 'Export source app'
  inputs:
    targetType: filePath
    filePath: ./bash/export.sh
    arguments: '-r westus2 -s $(SubscriptionKey) -c $(Culture) -a $(SourceAppId) -f ExportedDialogModel.json'
    workingDirectory: bash
    failOnStderr: true

- task: Bash@3
  displayName: 'Import to target app'
  inputs:
    targetType: filePath
    filePath: ./bash/import.sh
    arguments: '-r westus2 -s $(SubscriptionKey) -c $(Culture) -a $(TargetAppId) -f ExportedDialogModel.json'
    workingDirectory: bash
    failOnStderr: true

- task: Bash@3
  displayName: 'Train and Publish target app'
  inputs:
    targetType: filePath
    filePath: './bash/train-and-publish.sh'
    arguments: '-r westus2 -s $(SubscriptionKey) -c $(Culture) -a $(TargetAppId)'
    workingDirectory: bash
    failOnStderr: true

  6. Skrip ini mengasumsikan bahwa Anda menggunakan wilayah westus2, jika bukan itu masalahnya, perbarui argumen tugas yang sesuai

    Screenshot that highlights the region value in the arguments.

  7. Di tombol "Simpan dan jalankan", buka menu dropdown dan pilih "Simpan"

Hubungkan alur dengan aplikasi Anda

  1. Buka halaman utama alur.

  2. Di menu dropdown pada pojok kanan atas, pilih Edit alur. Hal ini akan mengarahkan Anda ke editor YAML.

  3. Di pojok kanan atas di samping tombol "Jalankan", pilih Variabel. Pilih Variabel baru.

  4. Tambahkan variabel ini:

    Variabel Deskripsi
    SourceAppId ID aplikasi DEV
    TargetAppId ID aplikasi PROD
    SubscriptionKey Kunci yang digunakan untuk kedua aplikasi
    Kultur Budaya aplikasi (en-us)

    Send Activity payload

  5. Pilih "Jalankan" lalu pilih "Pekerjaan" yang berjalan.

    Anda akan melihat daftar tugas yang sedang berjalan berisi: "Ekspor aplikasi sumber", "Impor ke aplikasi target" & "Latih dan Publikasikan aplikasi target"

Menyebarkan dari kode sumber

Jika Anda ingin menyimpan definisi aplikasi Anda dalam repositori, kami menyediakan skrip untuk penyebaran dari kode sumber. Karena skrip berada di bash, Jika Anda menggunakan Windows, Anda perlu menginstal subsistem Linux.

Skrip dihosting di Asisten Suara - Perintah Kustom. Kloning skrip di direktori bash ke repositori Anda. Pastikan Anda mempertahankan jalur yang sama.

Siapkan repositori Anda

  1. Buat direktori untuk aplikasi Anda, dalam contoh kami, buat direktori yang disebut "aplikasi".

  2. Perbarui argumen skrip bash di bawah ini, dan jalankan. Ini mengimpor model dialog aplikasi Anda ke file myapp.json

    bash/export.sh -r <region> -s <subscriptionkey> -c en-us -a <appid> -f apps/myapp.json
    Argumen Deskripsi
    wilayah Wilayah sumber daya Ucapan Anda. Misalnya: westus2
    subscriptionkey Kunci sumber daya Ucapan Anda.
    appid ID aplikasi Perintah Kustom yang ingin Anda ekspor.

  3. Dorong perubahan ini ke repositori Anda.

Menyiapkan alur

  1. Buka Azure DevOps - Alur dan pilih "Alur Baru"

  2. Di bagian Hubungkan, pilih lokasi repositori tempat skrip ini berada

  3. Di bagian Pilih, pilih repositori Anda

  4. Di bagian Konfigurasi, pilih "Alur awal"

  5. Selanjutnya Anda mendapatkan editor dengan file YAML, ganti bagian "langkah" dengan skrip ini.

    steps:
- task: Bash@3
  displayName: 'Import app'
  inputs:
    targetType: filePath
    filePath: ./bash/import.sh
    arguments: '-r westus2 -s $(SubscriptionKey) -c $(Culture) -a $(TargetAppId) -f ../apps/myapp.json'
    workingDirectory: bash
    failOnStderr: true

- task: Bash@3
  displayName: 'Train and Publish app'
  inputs:
    targetType: filePath
    filePath: './bash/train-and-publish.sh'
    arguments: '-r westus2 -s $(SubscriptionKey) -c $(Culture) -a $(TargetAppId)'
    workingDirectory: bash
    failOnStderr: true

    Catatan

    skrip ini mengasumsikan bahwa Anda menggunakan wilayah westus2, jika bukan itu masalahnya, perbarui argumen tugas yang sesuai

  6. Di tombol "Simpan dan jalankan", buka menu dropdown dan pilih "Simpan"

Menghubungkan alur dengan aplikasi target Anda

  1. Buka halaman utama alur.

  2. Di menu dropdown pada pojok kanan atas, pilih Edit alur. Hal ini akan mengarahkan Anda ke editor YAML.

  3. Di pojok kanan atas di samping tombol "Jalankan", pilih Variabel. Pilih Variabel baru.

  4. Tambahkan variabel ini:

    Variabel Deskripsi
    TargetAppId ID aplikasi PROD
    SubscriptionKey Kunci yang digunakan untuk kedua aplikasi
    Kultur Budaya aplikasi (en-us)

  5. Pilih "Jalankan" lalu pilih "Pekerjaan" yang berjalan. Anda akan melihat daftar tugas yang sedang berjalan berisi: "Impor aplikasi" & "Latih dan Publikasikan aplikasi"

Langkah berikutnya

Lihat contoh di GitHub