Tutorial: Buat pipeline yang menerapkan keterampilan Amazon Alexa - AWS CodePipeline
PrasyaratLangkah 1: Buat profil LWA keamanan layanan pengembang AlexaLangkah 2: Buat file sumber keterampilan Alexa dan dorong ke repositori Anda CodeCommit Langkah 3: Gunakan ASK CLI perintah untuk membuat token penyegaranLangkah 4: Buat pipeline Anda Langkah 5: Buat perubahan pada file sumber apa pun dan verifikasi penyebaran

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

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.

penting

Sebagai bagian dari pembuatan pipa, ember artefak S3 yang disediakan oleh pelanggan akan digunakan CodePipeline untuk artefak. (Ini berbeda dari bucket yang digunakan untuk aksi sumber S3.) Jika bucket artefak S3 berada di akun yang berbeda dari akun untuk pipeline Anda, pastikan bucket artefak S3 dimiliki oleh Akun AWS yang aman dan dapat diandalkan.

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.

Prasyarat

Anda harus sudah memiliki yang berikut:

Langkah 1: Buat profil LWA keamanan 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 Pengembalian yang Diizinkan URLs seperti yang disediakan dalam instruksi. URLsIzinkan ASK CLI perintah untuk mengarahkan permintaan token refresh.

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 ASK CLI perintah 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 tombol ASK CLI untuk membuat token. Anda menggunakan kredensi ini saat menggunakan wizard Create Pipeline.

Untuk membuat token penyegaran dengan kredensi 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 kredensi 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 V2. Untuk informasi selengkapnya, lihat Jenis pipa. Pilih Berikutnya.

  6. Di peran Layanan, pilih Peran layanan baru CodePipeline untuk memungkinkan membuat peran layananIAM.

  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 Berikutnya.

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

    Pilih Berikutnya.

  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.

      Langkah 4: Menyebarkan halaman untuk tindakan Alexa Skills Kit

    6. Pilih Berikutnya.

  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.