Tutorial: Buat pipeline yang menerapkan keterampilan Amazon Alexa

Dalam tutorial ini, Anda mengonfigurasi pipeline yang terus-menerus memberikan keterampilan Alexa Anda menggunakan Alexa Skills Kit sebagai penyedia penerapan di tahap penerapan Anda. Pipeline yang telah selesai mendeteksi perubahan pada keahlian Anda saat Anda membuat perubahan pada file sumber di repositori sumber Anda. Pipeline 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 penerapan lain yang tersedia di Wilayah tersebut, lihatMenyebarkan integrasi tindakan.

Untuk membuat skill kustom Anda sebagai fungsi Lambda, lihat Menghosting Keterampilan Kustom sebagai Fungsi Lambda AWS. Anda juga dapat membuat pipeline yang menggunakan file sumber Lambda dan CodeBuild proyek untuk menyebarkan perubahan ke Lambda untuk keahlian Anda. Misalnya, untuk membuat keterampilan baru dan fungsi Lambda terkait, Anda dapat membuat AWS CodeStar proyek. Lihat Membuat Proyek Keterampilan Alexa di AWS CodeStar. Untuk opsi itu, pipeline menyertakan tahap build ketiga dengan CodeBuild tindakan dan tindakan di tahap Deploy untuk AWS CloudFormation.

Prasyarat

Anda harus sudah memiliki yang berikut:

• Sebuah CodeCommit repositori. Anda dapat menggunakan AWS CodeCommit repositori yang Anda buat. Tutorial: Buat pipeline sederhana (CodeCommitrepositori)

• Akun pengembang Amazon. Ini adalah akun yang memiliki keterampilan Alexa Anda. Anda dapat membuat akun secara gratis di Alexa Skills Kit.

• Keterampilan Alexa. Anda dapat membuat contoh keterampilan menggunakan tutorial Get Custom Skill Sample Code.

• Instal ASK CLI dan konfigurasikan menggunakan kredensyal ask init Anda AWS . Lihat Menginstal dan menginisialisasi ASK CLI.

Langkah 1: Buat profil keamanan LWA layanan pengembang Alexa

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

• Gunakan langkah-langkah generate-lwa-tokensuntuk membuat Profil Keamanan.

• Setelah Anda membuat profil, catat ID Klien dan Rahasia Klien.

• Pastikan Anda memasukkan URL Pengembalian yang Diizinkan seperti yang disediakan dalam instruksi. URL memungkinkan perintah ASK CLI untuk mengalihkan permintaan token penyegaran.

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

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

• File skill.json.

• Sebuah interactionModel/custom folder.

  catatan

  Struktur direktori ini sesuai dengan persyaratan format paket keterampilan Alexa Skills Kit, sebagaimana diuraikan dalam format 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

   Temukan keahlian Anda berdasarkan nama dan kemudian salin ID terkait di skillId bidang.

2. Hasilkan skill.json file yang berisi detail keahlian Anda. Gunakan perintah ini:

   ask api get-skill -s skill-ID > skill.json

3. (Opsional) Buat interactionModel/custom folder.

   Gunakan perintah ini untuk menghasilkan file model interaksi di 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 CodeCommit repositori Anda

1. Dorong atau unggah file ke CodeCommit repositori Anda. File-file ini adalah artefak sumber yang dibuat oleh wizard Create Pipeline untuk tindakan penerapan Anda. AWS 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 di komputer lokal Anda:

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

         git add -A

      2. Jalankan perintah berikut untuk mengkomit file dengan pesan komit:

         git commit -m "Added Alexa skill files"

      3. Jalankan perintah berikut untuk mendorong file dari repo lokal Anda ke CodeCommit repositori Anda:

         git push

   2. Untuk menggunakan CodeCommit konsol untuk mengunggah file Anda:

      1. Buka CodeCommit konsol, dan pilih repositori Anda dari daftar Repositori.

      2. Pilih Tambahkan file, lalu pilih Unggah file.

      3. Pilih Pilih file, lalu 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 penyegaran

CodePipeline menggunakan token penyegaran berdasarkan ID klien dan rahasia di akun pengembang Amazon Anda untuk mengotorisasi tindakan yang dilakukannya atas nama Anda. Di bagian ini, Anda menggunakan ASK CLI untuk membuat token. Anda menggunakan kredensyal ini saat menggunakan wizard Create Pipeline.

Untuk membuat token penyegaran dengan kredensyal akun pengembang Amazon Anda

1. Gunakan perintah berikut ini.

   ask util generate-lwa-tokens

2. Saat diminta, masukkan ID klien dan rahasia Anda 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 browser masuk ditampilkan. Masuk dengan kredensyal akun pengembang Amazon Anda.

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

Langkah 4: Buat pipeline Anda

Dalam bagian ini, Anda membuat alur dengan tindakan berikut:

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

• Tahap penyebaran dengan tindakan penerapan Alexa Skills Kit.

Untuk membuat alur dengan wizard

1. Masuk ke AWS Management Console dan buka CodePipeline konsol di http://console.aws.amazon.com/codesuite/codepipeline/home.

2. Pilih AWS Wilayah tempat Anda ingin membuat proyek dan sumber dayanya. Runtime skill Alexa hanya tersedia di Wilayah berikut:

   • Asia Pasifik (Tokyo)

   • Eropa (Irlandia)

   • AS Timur (Virginia Utara)

   • AS Barat (Oregon)

3. Pada halaman Selamat Datang, halaman Memulai, atau halaman Pipelines, pilih Buat pipeline.

4. Di Langkah 1: Pilih pengaturan alur, di Nama alur, masukkan MyAlexaPipeline.

5. Dalam tipe Pipeline, pilih V1 untuk keperluan tutorial ini. Anda juga dapat memilih V2; Namun, perhatikan bahwa jenis pipa berbeda dalam karakteristik dan harga. Untuk informasi selengkapnya, lihat Jenis pipa.

6. Dalam peran Layanan, pilih Peran layanan baru CodePipeline untuk memungkinkan membuat peran layanan di IAM.

7. Biarkan pengaturan di bawah Pengaturan lanjutan pada defaultnya, lalu pilih Berikutnya.

8. Pada Langkah 2: Tambahkan tahap sumber, di penyedia Sumber, pilih AWS CodeCommit. Dalam nama Repositori, pilih nama CodeCommit repositori yang Anda buat. Langkah 1: Buat CodeCommit repositori Di Nama cabang, pilih 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.

9. Pada Langkah 3: Tambahkan tahap build, pilih Lewati tahap build, lalu terima pesan peringatan dengan memilih Lewati lagi.

   Pilih Selanjutnya.

10. Pada Langkah 4: Tambahkan tahap penerapan:

    1. Di penyedia Deploy, pilih Alexa Skills Kit.

    2. Di ID keterampilan Alexa, masukkan ID keterampilan yang ditetapkan untuk keahlian Anda di konsol pengembang Alexa Skills Kit.

    3. Di Client ID, masukkan ID aplikasi yang Anda daftarkan.

    4. Dalam rahasia Klien, masukkan rahasia yang Anda pilih saat mendaftar.

    5. Di Refresh token, masukkan token yang Anda buat di langkah 3.

       

    6. Pilih Selanjutnya.

11. Pada Langkah 5: Tinjau, tinjau informasi, lalu pilih Buat pipeline.

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

Buat perubahan pada keahlian Anda dan kemudian dorong perubahan ke repositori Anda. Ini memicu pipeline Anda untuk berjalan. Verifikasi bahwa keahlian Anda diperbarui di konsol pengembang Alexa Skills Kit.