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

Menggunakan dependensi dengan kenari Synthetics CloudWatch

Bagian ini menjelaskan cara menggunakan kenari Dependencies CloudWatch Synthetics. DependenciesBidang ini memungkinkan Anda menentukan dependensi untuk kenari Anda, memungkinkan Anda untuk menyertakan pustaka tambahan atau kode khusus yang dapat digunakan skrip kenari Anda.

Ikhtisar

CloudWatch Synthetics canaries mendukung menentukan lapisan Lambda sebagai dependensi. Fitur ini memungkinkan Anda untuk:

Didukung APIs

DependenciesBidang ini didukung sebagai berikut APIs:

Sintaksis

DependenciesBidang adalah bagian dari struktur kode dalam sintaks permintaan:

"Code": { 
  "Handler": "string",
  "S3Bucket": "string",
  "S3Key": "string",
  "S3Version": "string",
  "ZipFile": blob,
  "Dependencies": [
    {
      "Type": "LambdaLayer",
      "Reference": "string"
    }
  ]
}

Menggunakan dependensi

Berikut adalah beberapa contoh dan instruksi untuk menggunakan Dependencies bidang dalam skenario yang berbeda.

Membuat Canary dengan dependensi

Saat membuat kenari, Anda dapat menentukan lapisan Lambda sebagai ketergantungan:

{
  "Name": "my-canary",
  "Code": {
    "Handler": "pageLoadBlueprint.handler",
    "S3Bucket": "my-bucket",
    "S3Key": "my-canary-script.zip",
    "Dependencies": [
      {
        "Type": "LambdaLayer",
        "Reference": "arn:aws:lambda:us-west-2:123456789012:layer:my-custom-layer:1"
      }
    ]
  },
  "ArtifactS3Location": "s3://my-bucket/artifacts/",
  "ExecutionRoleArn": "arn:aws:iam::123456789012:role/my-canary-role",
  "Schedule": {
    "Expression": "rate(5 minutes)"
  },
  "RuntimeVersion": "syn-nodejs-puppeteer-3.9"
}

Memperbarui dependensi Canary

Anda dapat memperbarui dependensi kenari menggunakan API: UpdateCanary

{
  "Name": "my-canary",
  "Code": {
    "Dependencies": [
      {
        "Type": "LambdaLayer",
        "Reference": "arn:aws:lambda:us-west-2:123456789012:layer:my-updated-layer:2"
      }
    ]
  }
}

Menghapus dependensi

Untuk menghapus dependensi dari kenari, sediakan array kosong untuk bidang Dependencies:

{
  "Name": "my-canary",
  "Code": {
    "Dependencies": []
  }
}

Menguji dependensi dengan StartCanaryDryRun

Sebelum memperbarui kenari dengan dependensi baru, Anda dapat mengujinya menggunakan API: StartCanaryDryRun

{
  "Name": "my-canary",
  "Code": {
    "Dependencies": [
      {
        "Type": "LambdaLayer",
        "Reference": "arn:aws:lambda:us-west-2:123456789012:layer:my-test-layer:3"
      }
    ]
  }
}

Pertimbangan dan batasan

Membuat lapisan Lambda yang kompatibel

Untuk informasi tentang cara membuat dan mengemas lapisan, lihat Mengelola dependensi Lambda dengan lapisan dan untuk memahami struktur kemasan pemeriksaan kenari berdasarkan struktur pengepakan kenari, lihat Menulis skrip kenari.