

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

# Tutorial: Gunakan AWS Step Functions tindakan pemanggilan dalam pipeline
<a name="tutorials-step-functions"></a>

Anda dapat menggunakan AWS Step Functions untuk membuat dan mengkonfigurasi mesin negara. Tutorial ini menunjukkan cara menambahkan tindakan pemanggilan ke pipeline yang mengaktifkan eksekusi mesin status dari pipeline Anda. 

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

Dalam tutorial ini, Anda melakukan tugas-tugas berikut:
+ Buat mesin status standar di AWS Step Functions.
+ Masukkan input mesin status JSON secara langsung. Anda juga dapat mengunggah file input mesin status ke bucket Amazon Simple Storage Service (Amazon S3).
+ Perbarui pipeline Anda dengan menambahkan tindakan mesin status.

**Topics**
+ [Prasyarat: Buat atau pilih pipa sederhana](#tutorials-step-functions-prereq)
+ [Langkah 1: Buat mesin status sampel](#tutorials-step-functions-sample)
+ [Langkah 2: Tambahkan tindakan pemanggilan Step Functions ke pipeline Anda](#tutorials-step-functions-pipeline)

## Prasyarat: Buat atau pilih pipa sederhana
<a name="tutorials-step-functions-prereq"></a>

Dalam tutorial ini, Anda menambahkan tindakan pemanggilan ke pipeline yang ada. Anda dapat menggunakan pipeline yang Anda buat di [Tutorial: Buat pipeline sederhana (ember S3)](tutorials-simple-s3.md) atau[Tutorial: Buat pipeline sederhana (CodeCommit repositori)](tutorials-simple-codecommit.md).

Anda menggunakan pipeline yang ada dengan aksi sumber dan setidaknya struktur dua tahap, tetapi Anda tidak menggunakan artefak sumber untuk contoh ini.

**catatan**  
Anda mungkin perlu memperbarui peran layanan yang digunakan oleh pipeline Anda dengan izin tambahan yang diperlukan untuk menjalankan tindakan ini. Untuk melakukannya, buka konsol AWS Identity and Access Management (IAM), cari peran, lalu tambahkan izin ke kebijakan peran. Untuk informasi selengkapnya, lihat [Menambahkan izin ke peran CodePipeline layanan](how-to-custom-role.md#how-to-update-role-new-services).

## Langkah 1: Buat mesin status sampel
<a name="tutorials-step-functions-sample"></a>

Di konsol Step Functions, buat mesin status menggunakan template `HelloWorld` sampel. Untuk petunjuk, lihat [Membuat Mesin Status](https://docs.aws.amazon.com/step-functions/latest/dg/getting-started.html#create-state-machine) di *Panduan AWS Step Functions Pengembang*.

## Langkah 2: Tambahkan tindakan pemanggilan Step Functions ke pipeline Anda
<a name="tutorials-step-functions-pipeline"></a>

Tambahkan tindakan pemanggilan Step Functions ke pipeline Anda sebagai berikut:

1. Masuk ke Konsol Manajemen AWS dan buka CodePipeline konsol di [http://console.aws.amazon. com/codesuite/codepipeline/home](https://console.aws.amazon.com/codesuite/codepipeline/home).

   Nama-nama semua pipeline yang terkait dengan AWS akun Anda ditampilkan.

1. Di **Nama**, pilih nama pipeline yang ingin Anda edit. Ini membuka tampilan rinci dari pipa, termasuk keadaan masing-masing tindakan di setiap tahap pipa.

1. Pada halaman detail pipeline, pilih **Edit**.

1. Pada tahap kedua dari pipeline sederhana Anda, pilih **Edit tahap**. Pilih **Hapus**. Ini menghapus tahap kedua sekarang karena Anda tidak lagi membutuhkannya.

1. Di bagian bawah diagram, pilih **\$1 Tambahkan tahap**.

1. Di **Nama panggung**, masukkan nama untuk panggung, seperti**Invoke**, lalu pilih **Tambah tahap**.

1. Pilih **\$1 Tambahkan grup tindakan**.

1. Dalam **nama Action**, masukkan nama, seperti**Invoke**.

1. Di **penyedia Action**, pilih **AWS Step Functions**. Izinkan **Wilayah** ke default ke Wilayah alur.

1. Di **artefak Input**, pilih`SourceArtifact`.

1. Di **mesin ARN negara**, pilih Nama Sumber Daya Amazon (ARN) untuk mesin status yang Anda buat sebelumnya.

1. (Opsional) Dalam **awalan nama Eksekusi**, masukkan awalan yang akan ditambahkan ke ID eksekusi mesin negara.

1. Di **tipe Input**, pilih **Literal**.

1. Di **Input**, masukkan input JSON yang diharapkan oleh mesin status `HelloWorld` sampel.
**catatan**  
Input untuk eksekusi mesin keadaan berbeda dari istilah yang digunakan CodePipeline untuk menggambarkan artefak input untuk tindakan.

   Untuk contoh ini, masukkan JSON berikut:

   ```
   {"IsHelloWorldExample": true}
   ```

1. Pilih **Selesai**.

1. Di panggung yang Anda edit, pilih **Selesai**. Di AWS CodePipeline panel, pilih **Simpan**, lalu pilih **Simpan** pada pesan peringatan.

1. Untuk mengirimkan perubahan dan memulai eksekusi pipeline, pilih **Rilis perubahan**, lalu pilih **Rilis**.

1. Pada pipeline yang telah selesai, pilih **AWS Step Functions** dalam tindakan pemanggilan Anda. Di AWS Step Functions konsol, lihat ID eksekusi mesin status Anda. ID menunjukkan nama mesin status Anda `HelloWorld` dan ID eksekusi mesin status dengan awalan`my-prefix`.

   ```
   arn:aws:states:us-west-2:account-ID:execution:HelloWorld:my-prefix-0d9a0900-3609-4ebc-925e-83d9618fcca1
   ```