Menerapkan Tugas AWS Lambda - AWS Flow Framework untuk Java
Tentang AWS LambdaManfaat dan pembatasan dalam menggunakan tugas LambdaMenggunakan tugas Lambda di AWS Flow Framework Anda untuk alur kerja JavaMelihatHelloLambdasampel

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

Menerapkan Tugas AWS Lambda

Tentang AWS Lambda

AWS Lambda adalah layanan komputasi terkelola penuh yang menjalankan kode Anda untuk merespons kejadian yang dihasilkan oleh kode kustom atau dari berbagai layanan AWS seperti Amazon S3, DynamoDB, Amazon Kinesis, Amazon SNS, dan Amazon Cognito. Untuk informasi selengkapnya tentang Lambda, lihat Panduan Developer AWS Lambda.

Amazon Simple Workflow Service menyediakan tugas Lambda sehingga Anda dapat menjalankan fungsi Lambda untuk menggantikan, atau digunakan bersama kegiatan Amazon SWF tradisional.

penting

Akun AWS Anda akan dikenakan biaya untuk eksekusi Lambda (permintaan) yang dieksekusi oleh Amazon SWF atas nama Anda. Untuk detail tentang harga Lambda, lihat https://aws.amazon.com/lambda/pricing/.

Manfaat dan pembatasan dalam menggunakan tugas Lambda

Ada sejumlah manfaat menggunakan tugas Lambda dibandingkan menjalankan kegiatan Amazon SWF tradisional:

  • Tugas Lambda tidak perlu didaftarkan atau diversikan seperti tipe aktivitas Amazon SWF.

  • Anda dapat menggunakan fungsi Lambda yang ada yang telah Anda tetapkan dalam alur kerja Anda.

  • Fungsi Lambda dipanggil langsung oleh Amazon SWF; Anda tidak perlu menerapkan program pekerja untuk mengeksekusi fungsi seperti yang harus Anda lakukan pada kegiatan tradisional.

  • Lambda menyediakan metrik dan pencatatan untuk melacak dan menganalisis eksekusi fungsi Anda.

Ada juga sejumlah batasan mengenai tugas Lambda yang harus Anda sadari:

  • Tugas Lambda hanya dapat dijalankan di wilayah AWS yang menyediakan dukungan untuk Lambda. Lihat Wilayah dan Titik Akhir Lambda di Referensi Umum Amazon Web Services untuk detail tentang wilayah yang saat ini didukung untuk Lambda.

  • Tugas Lambda saat ini didukung hanya oleh SWF HTTP API dasar dan di AWS Flow Framework untuk Java. Saat ini tidak ada dukungan untuk tugas Lambda di AWS Flow Framework untuk Ruby.

Menggunakan tugas Lambda di AWS Flow Framework Anda untuk alur kerja Java

Ada tiga persyaratan untuk menggunakan tugas Lambda di AWS Flow Framework Anda untuk alur kerja Java:

  • Sebuah fungsi Lambda untuk mengeksekusi. Anda dapat menggunakan fungsi Lambda yang telah Anda tetapkan. Untuk informasi lebih lanjut tentang cara membuat fungsi Lambda, lihat AWS Lambda Developer Guide (Panduan Developer).

  • IAM role yang menyediakan akses untuk menjalankan fungsi Lambda dari alur kerja Amazon SWF Anda.

  • Kode untuk menjadwalkan tugas Lambda dari dalam alur kerja Anda.

Mengatur IAM role

Sebelum Anda dapat memanggil fungsi Lambda dari Amazon SWF Anda harus menyediakan IAM role yang menyediakan akses ke Lambda dari Amazon SWF. Anda dapat:

  • memilih peran yang telah ditentukan,AWSLambdaRole, untuk memberikan izin bagi alur kerja Anda guna memanggil fungsi Lambda apa pun yang terkait dengan akun Anda.

  • menentukan kebijakan dan peran terkait milik Anda untuk memberikan izin bagi alur kerja untuk memanggil fungsi Lambda tertentu, yang ditentukan oleh Amazon Resource Names (ARN) fungsi.

Batasi izin pada peran IAM

Anda dapat membatasi izin pada peran IAM yang Anda berikan kepada Amazon SWF dengan menggunakanSourceArndanSourceAccountkunci konteks dalam kebijakan kepercayaan sumber daya Anda. Kunci ini membatasi penggunaan kebijakan IAM sehingga hanya digunakan dari eksekusi Amazon Simple Workflow Service yang termasuk dalam ARN domain yang ditentukan. Jika Anda menggunakan kedua kunci konteks kondisi global,aws:SourceAccountnilai dan akun yang direferensikan dalamaws:SourceArnnilai harus menggunakan ID akun yang sama bila digunakan dalam pernyataan kebijakan yang sama.

Dalam contoh kebijakan kepercayaan berikut, kami menggunakanSourceArnkunci konteks untuk membatasi peran layanan IAM untuk hanya digunakan dalam eksekusi Amazon Simple Workflow Service miliksomeDomaindi akun,123456789012.

{
  "Version": "2012-10-17",
  "Statement": [
     {
       "Sid": "",
       "Effect": "Allow",
       "Principal": {
         "Service": "swf.amazonaws.com"
       },
       "Action": "sts:AssumeRole",
       "Condition": {
         "ArnLike": {
           "aws:SourceArn": "arn:aws:swf:*:123456789012:/domain/someDomain"
       }
      }
    }
  ]
}

Dalam contoh kebijakan kepercayaan berikut, kami menggunakanSourceAccountkunci konteks untuk membatasi peran layanan IAM untuk hanya digunakan dalam eksekusi Amazon Simple Workflow Service di akun,123456789012.

{
  "Version": "2012-10-17",
  "Statement": [
     {
       "Sid": "",
       "Effect": "Allow",
       "Principal": {
         "Service": "swf.amazonaws.com"
       },
       "Action": "sts:AssumeRole",
       "Condition": {
         "StringLike": {
           "aws:SourceAccount": "123456789012"
       }
      }
    }
  ]
}

Menyediakan akses bagi Amazon SWF untuk memanggil setiap peran Lambda

Anda dapat menggunakan peran yang telah ditentukan,AWSLambdaRole, untuk memberikan alur kerja Amazon SWF Anda kemampuan untuk memanggil fungsi Lambda apa pun yang terkait dengan akun Anda.

Untuk menggunakanAWSLambdaRolememberikan akses Amazon SWF guna memanggil fungsi Lambda

  1. Buka Amazon IAM console (Konsol Amazon IAM).

  2. Pilih Roles (Peran), kemudian Create New Role (Buat Peran Baru).

  3. Beri nama bagi peran Anda, misalnya swf-lambda dan pilih Next Step (Langkah Selanjutnya).

  4. Di bawah AWS Service Roles (Peran Layanan), pilih Amazon SWF, dan pilih Next Step (Langkah Berikutnya).

  5. PadaLampirkan Kebijakanlayar, pilihAWSLambdaRoledari dalam daftar.

  6. Pilih Next Step (Langkah Selanjutnya) dan kemudian Create Role (Buat Baru) setelah Anda meninjau peran tersebut.

Menentukan IAM role untuk menyediakan akses guna memanggil fungsi Lambda tertentu

Jika Anda ingin menyediakan akses untuk memanggil fungsi Lambda tertentu dari alur kerja Anda, Anda perlu menentukan kebijakan IAM Anda sendiri.

Untuk membuat kebijakan IAM untuk menyediakan akses ke fungsi Lambda tertentu

  1. Buka Amazon IAM console (Konsol Amazon IAM).

  2. Pilih Policies (Kebijakan), kemudian Create Policy (Buat Kebijakan).

  3. PilihSalinAWSKebijakan Terkeloladan pilihAWSLambdaRoledari dalam daftar. Sebuah kebijakan akan dibuat untuk Anda. Anda memiliki opsi untuk mengedit nama dan deskripsi kebijakan untuk menyesuaikan kebutuhan Anda.

  4. Di bidang Sumber Daya di Dokumen Kebijakan, tambahkan ARN dari satu atau beberapa fungsi Lambda Anda. Sebagai contoh:

    {
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "lambda:InvokeFunction"
      ],
      "Resource": [
        "arn:aws:lambda:us-east-1:111111000000:function:hello_lambda_function"
      ]
    }
  ]
}
    catatan

    Untuk keterangan lengkap tentang cara menentukan sumber daya di IAM role, lihat Gambaran Umum Kebijakan IAM di Menggunakan IAM.

  5. Pilih Create Policy (Buat Kebijakan) untuk menyelesaikan pembuatan kebijakan Anda.

Anda kemudian dapat memilih kebijakan ini saat membuat IAM role baru, dan menggunakan peran tersebut untuk memberikan akses panggilan ke alur kerja Amazon SWF Anda. Prosedur ini sangat mirip dengan membuat peranAWSLambdaRolekebijakan. sebaliknya, pilih kebijakan Anda sendiri saat membuat peran.

Untuk membuat peran Amazon SWF menggunakan kebijakan Lambda Anda

  1. Buka Amazon IAM console (Konsol Amazon IAM).

  2. Pilih Roles (Peran), kemudian Create New Role (Buat Peran Baru).

  3. Beri nama bagi peran Anda, misalnya swf-lambda-function dan pilih Next Step (Langkah Selanjutnya).

  4. Di bawah AWS Service Roles (Peran Layanan), pilih Amazon SWF, dan pilih Next Step (Langkah Berikutnya).

  5. Pada layar Attach Policy (Lampirkan Kebijakan), pilih kebijakan khusus fungsi Lambda Anda dari daftar.

  6. Pilih Next Step (Langkah Selanjutnya) dan kemudian Create Role (Buat Baru) setelah Anda meninjau peran tersebut.

Jadwalkan tugas Lambda untuk eksekusi

Setelah Anda menentukan IAM role yang mengizinkan Anda untuk memanggil fungsi Lambda, Anda dapat menjadwalkan mereka untuk eksekusi sebagai bagian dari alur kerja Anda.

catatan

Proses ini sepenuhnya ditunjukkan olehHelloLambdasampeldiAWS SDK for Java.

Untuk menjadwalkan tugas Lambda untuk eksekusi

  1. Dalam penerapan alur kerja Anda, dapatkan instans LambdaFunctionClient dengan memanggil getLambdaFunctionClient() pada instans DecisionContext.

    
// Get a LambdaFunctionClient instance
DecisionContextProvider decisionProvider = new DecisionContextProviderImpl();
DecisionContext decisionContext = decisionProvider.getDecisionContext();
LambdaFunctionClient lambdaClient = decisionContext.getLambdaFunctionClient();

  2. Jadwal tugas menggunakan metode scheduleLambdaFunction() di LambdaFunctionClient, dengan meneruskan metode nama fungsi Lambda yang Anda buat dan data input apa pun untuk tugas Lambda.

    
// Schedule the Lambda function for execution, using your IAM role for access.
String lambda_function_name = "The name of your Lambda function.";
String lambda_function_input = "Input data for your Lambda task.";

lambdaClient.scheduleLambdaFunction(lambda_function_name, lambda_function_input);

  3. Di starter eksekusi alur kerja Anda, tambahkan peran lambda IAM ke opsi alur kerja default dengan menggunakan StartWorkflowOptions.withLambdaRole(), dan kemudian teruskan pilihan ketika memulai alur kerja.

    
// Workflow client classes are generated for you when you use the @Workflow
// annotation on your workflow interface declaration.
MyWorkflowClientExternalFactory clientFactory =
  new MyWorkflowClientExternalFactoryImpl(sdk_swf_client, swf_domain);

MyWorkflowClientExternal workflow_client = clientFactory.getClient();

// Give the ARN of an IAM role that allows SWF to invoke Lambda functions on
// your behalf.
String lambda_iam_role = "arn:aws:iam::111111000000:role/swf_lambda_role";

StartWorkflowOptions workflow_options =
  new StartWorkflowOptions().withLambdaRole(lambda_iam_role);

// Start the workflow execution
workflow_client.helloWorld("User", workflow_options);

MelihatHelloLambdasampel

Contoh yang menyediakan implementasi alur kerja yang menggunakan tugas Lambda disediakan di AWS SDK for Java. Untuk melihat dan/atau menjalankannya, download the source (unduh sumber).

Deskripsi lengkap tentang bagaimana membangun dan menjalankanHelloLambdasampel disediakan dalam file README disediakan denganAWS Flow Frameworkuntuk sampel Java.