Tutorial: Buat pipeline yang menyebarkan keterampilan Amazon Alexa - AWS CodePipeline

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Tutorial: Buat pipeline yang menyebarkan keterampilan Amazon Alexa

Dalam tutorial ini, Anda mengkonfigurasi pipeline yang terus memberikan keahlian Alexa Anda menggunakan Alexa Skills Kit sebagai penyedia penyebaran di tahap penyebaran Anda. Pipa yang telah selesai mendeteksi perubahan pada keahlian Anda saat Anda membuat perubahan pada file sumber di repositori sumber Anda. Pipa kemudian menggunakan Alexa Skills Kit untuk menyebarkan ke tahap pengembangan keterampilan Alexa.

catatan

Fitur ini tidak tersedia di Wilayah Asia Pasifik (Hong Kong) atau Eropa (Milan). Untuk menggunakan tindakan penyebaran lain yang tersedia di Wilayah tersebut, lihatDeploy action kontinu.

Untuk membuat keahlian khusus Anda sebagai fungsi Lambda, lihatHost Keterampilan Kustom sebagaiAWSFungsi Lambda. Anda juga dapat membuat pipeline yang menggunakan file sumber Lambda dan proyek CodeBuild untuk menyebarkan perubahan pada Lambda untuk keahlian Anda. Misalnya, untuk membuat keterampilan baru dan fungsi Lambda terkait, Anda dapat membuat proyek AWS CodeStar. LihatMembuat Proyek Keterampilan Alexa di AWS CodeStar. Untuk opsi itu, pipeline menyertakan tahap pembangunan ketiga dengan tindakan CodeBuild dan tindakan di tahap Deploy untukAWS CloudFormation.

Prasyarat

Anda harus memiliki yang berikut ini:

Langkah 1: Buat profil keamanan LWA layanan pengembang Alexa

Pada bagian ini, Anda membuat profil keamanan untuk digunakan dengan Login with Amazon (LWA). Jika sudah memiliki profil, Anda dapat melewati langkah ini.

  • Gunakan langkah-langkah dimenghasilkan-lwa-tokenuntuk membuat Profil Keamanan.

  • Setelah Anda membuat profil, membuat catatanID kliendanRahasia klien.

  • Pastikan Anda memasukkanURL Pengembalian yang Diizinkansebagaimana disediakan dalam petunjuknya. URL memungkinkan perintah ASK CLI untuk mengarahkan permintaan token refresh.

Langkah 2: Buat file sumber keterampilan Alexa dan dorong ke repositori CodeCommit Anda

Pada bagian ini, Anda membuat dan mendorong file sumber keterampilan Alexa Anda ke repositori yang digunakan pipa untuk tahap sumber Anda. Untuk keterampilan yang telah Anda buat di konsol pengembang Amazon, Anda memproduksi dan mendorong yang berikut ini:

  • File skill.json.

  • SesiinteractionModel/customfolder.

    catatan

    Struktur direktori ini sesuai dengan persyaratan format paket keterampilan Alexa Skills Kit, seperti yang diuraikan dalamFormat paket keterampilan. Jika struktur direktori Anda tidak menggunakan format paket keterampilan yang benar, perubahan tidak berhasil diterapkan ke konsol Alexa Skills Kit.

Untuk membuat file sumber untuk keahlian Anda

  1. Ambil ID keahlian Anda dari konsol pengembang Alexa Skills Kit. Gunakan perintah ini:

    ask api list-skills

    Cari keahlian Anda berdasarkan nama dan kemudian salin ID terkait diskillIdbidang.

  2. Menghasilkanskill.jsonfile yang berisi rincian keterampilan Anda. Gunakan perintah ini:

    ask api get-skill -s skill-ID > skill.json
  3. (Opsional) MembuatinteractionModel/customfolder.

    Gunakan perintah ini untuk menghasilkan file model interaksi dalam folder. Untuk lokal, tutorial ini menggunakan en-US sebagai lokal dalam nama file.

    ask api get-model --skill-id skill-ID --locale locale > ./interactionModel/custom/locale.json

Untuk mendorong file ke repositori CodeCommit

  1. Mendorong atau meng-upload file ke repositori CodeCommit Anda. File-file ini adalah artefak sumber yang dibuat olehMembuat Alurwizard untuk tindakan deployment Anda diAWS CodePipeline. File Anda akan terlihat seperti ini di direktori lokal Anda:

    skill.json /interactionModel /custom |en-US.json
  2. Pilih metode yang ingin Anda gunakan untuk mengunggah file Anda:

    1. Untuk menggunakan baris perintah Git dari repositori kloning pada komputer lokal Anda:

      1. Jalankan perintah berikut untuk tahap semua file Anda sekaligus:

        git add -A
      2. Jalankan perintah berikut untuk melakukan file dengan pesan commit:

        git commit -m "Added Alexa skill files"
      3. Jalankan perintah berikut untuk mendorong file dari repo lokal Anda ke repositori CodeCommit Anda:

        git push
    2. Untuk menggunakan konsol CodeCommit untuk mengunggah file Anda:

      1. Buka konsol CodeCommit, dan memilih repositori Anda dariRepositoridaftar.

      2. MemiilihTambahkan berkas, dan kemudian pilihUnggah file.

      3. MemiilihPilih file, dan kemudian telusuri file Anda. Lakukan perubahan dengan memasukkan nama pengguna dan alamat email Anda. Pilih Perubahan commit.

      4. Ulangi langkah ini untuk setiap file yang ingin Anda unggah.

Langkah 3: Gunakan perintah ASK CLI untuk membuat token refresh

CodePipeline menggunakan token penyegaran berdasarkan ID klien dan rahasia di akun pengembang Amazon Anda untuk mengotorisasi tindakan yang dilakukannya atas nama Anda. Pada bagian ini, Anda menggunakan ASK CLI untuk membuat token. Anda menggunakan kredenensi ini saat menggunakan kredenensiMembuat AlurPenyihir.

Untuk membuat token penyegaran dengan kredensi akun pengembang Amazon Anda

  1. Gunakan perintah berikut:

    ask util generate-lwa-tokens
  2. Ketika diminta, masukkan ID klien Anda dan rahasia seperti yang ditunjukkan dalam contoh ini:

    ? Please type in the client ID: amzn1.application-client.example112233445566 ? Please type in the client secret: example112233445566
  3. Halaman peramban masuk ditampilkan. Masuk dengan kredenal akun pengembang Amazon Anda.

  4. Kembali ke layar baris perintah. Token akses dan token penyegaran dihasilkan dalam output. Salin token refresh yang dikembalikan dalam output.

Langkah 4: Membuat Alur

Dalam bagian ini, Anda membuat alur dengan tindakan berikut:

  • Tahap sumber dengan aksi CodeCommit di mana artefak sumber adalah file keterampilan Alexa yang mendukung keterampilan Anda.

  • Tahap penyebaran dengan Alexa Skills Kit menyebarkan tindakan.

Untuk membuat alur dengan wizard

  1. Masuk keAWS Management Consoledan buka konsol CodePipeline dihttp://console.aws.amazon.com/codesuite/codepipeline/home.

  2. PilihAWSWilayah tempat Anda ingin membuat proyek dan sumber daya. Runtime skill Alexa hanya tersedia di Wilayah berikut:

    • Asia Pacific (Tokyo)

    • Europe (Ireland)

    • US East (N. Virginia)

    • US West (Oregon)

  3. PadaSelamat datanghalaman,Memulaihalaman, atauAlurhalaman, pilihMembuat Alur.

  4. Di Langkah 1: Pilih pengaturan pipa, diNama saluran, masukkanMyAlexaPipeline.

  5. MasukPeran layanan, pilihPeran layanan baruuntuk memungkinkan CodePipeline untuk membuat peran layanan di IAM.

  6. Biarkan pengaturan di bawahPengaturan lanjutandi default mereka, dan kemudian pilihSelanjutnya.

  7. Di Langkah 2: Tambahkan tahap sumber, diPenyedia sumber, pilihAWS CodeCommit. MasukNama repositori, memilih nama repositori CodeCommit yang Anda buatLangkah 1: Buat CodeCommit repositori. MasukNama cabang, memilih nama cabang yang berisi pembaruan kode terbaru Anda.

    Setelah Anda memilih nama repositori dan cabang, pesan menunjukkan aturan Amazon CloudWatch Events yang akan dibuat untuk pipeline ini.

    Pilih Selanjutnya.

  8. Di Langkah 3: Tambahkan tahap build, pilihLewati tahap build, dan kemudian menerima pesan peringatan dengan memilihLewatilagi.

    Pilih Selanjutnya.

  9. Di Langkah 4: Tambahkan tahap deploy:

    1. MasukPenyedia Deploy, pilihAlexa Skills Kit.

    2. MasukID keterampilan Alexa, masukkan ID keterampilan yang diberikan pada keahlian Anda di konsol pengembang Alexa Skills Kit.

    3. MasukID klien, masukkan ID aplikasi yang Anda daftarkan.

    4. MasukRahasia klien, masukkan rahasia yang Anda pilih saat Anda mendaftar.

    5. MasukToken refresh, masukkan token yang Anda buat di langkah 3.

      
                                ParameterLangkah 4: Deployhalaman untuk tindakan Alexa Skills Kit
    6. Pilih Selanjutnya.

  10. MasukLangkah 5: Tinjau, tinjau informasinya, lalu pilihMembuat Alur.

Langkah 5: Lakukan perubahan pada file sumber apa pun dan verifikasi penyebaran

Buat perubahan pada keahlian Anda dan kemudian dorong perubahan ke repositori Anda. Hal ini memicu pipa Anda untuk menjalankan. Verifikasi bahwa keterampilan Anda diperbarui diAlexa Keterampilan Kit konsol pengembang.