Cara menyesuaikan saluran pipa starter dengan AWS SAM - AWS Serverless Application Model
Contoh proyekContoh file

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

Cara menyesuaikan saluran pipa starter dengan AWS SAM

Sebagai administrator CI/CD, Anda mungkin ingin menyesuaikan template pipeline pemula, dan petunjuk terpandu terkait, yang dapat digunakan pengembang di organisasi Anda untuk membuat konfigurasi pipeline.

The AWS SAM CLI menggunakan template Cookiecutter saat membuat template pemula. Untuk detail tentang template pemotong kue, Cookiecutter.

Anda juga dapat menyesuaikan petunjuk yang AWS SAM CLI ditampilkan kepada pengguna saat membuat konfigurasi pipeline menggunakan sam pipeline init perintah. Untuk menyesuaikan permintaan pengguna, lakukan hal berikut:

  1. Buat questions.json file — questions.json File harus berada di root respositori proyek. Ini adalah direktori yang sama dengan cookiecutter.json file. Untuk melihat skema questions.json file, lihat questions.json.schema. Untuk melihat questions.json file contoh, lihat questions.json.

  2. Peta kunci pertanyaan dengan nama cookiecutter - Setiap objek dalam questions.json file membutuhkan kunci yang cocok dengan nama dalam template cookiecutter. Pencocokan kunci ini adalah bagaimana AWS SAM CLI memetakan tanggapan prompt pengguna ke template pemotong cookie. Untuk melihat contoh pencocokan kunci ini, lihat Contoh file bagian nanti dalam topik ini.

  3. Buat metadata.json file — Deklarasikan jumlah tahapan yang akan dimiliki pipeline dalam file. metadata.json Jumlah tahapan menginstruksikan sam pipeline init perintah berapa banyak tahapan untuk meminta informasi tentang, atau dalam kasus --bootstrap opsi, berapa banyak tahapan untuk membuat sumber daya infrastruktur untuk. Untuk melihat metadata.json file contoh yang mendeklarasikan pipeline dengan dua tahap, lihat metadata.json.

Contoh proyek

Berikut adalah contoh proyek, yang masing-masing menyertakan template Cookiecutter, questions.json file, dan file: metadata.json

Contoh file

Kumpulan file berikut menunjukkan bagaimana pertanyaan dalam questions.json file dikaitkan dengan entri dalam file template Cookiecutter. Perhatikan bahwa contoh ini adalah cuplikan file, bukan file lengkap. Untuk melihat contoh file lengkap, lihat Contoh proyek bagian sebelumnya dalam topik ini.

Contoh questions.json:

{
  "questions": [{
    "key": "intro",
    "question": "\nThis template configures a pipeline that deploys a serverless application to a testing and a production stage.\n",
    "kind": "info"
  }, {
    "key": "pipeline_user_jenkins_credential_id",
    "question": "What is the Jenkins credential ID (via Jenkins plugin \"aws-credentials\") for pipeline user access key?",
    "isRequired": true
  }, {
    "key": "sam_template",
    "question": "What is the template file path?",
    "default": "template.yaml"
  }, {
    ...

Contoh cookiecutter.json:

{
  "outputDir": "aws-sam-pipeline",
  "pipeline_user_jenkins_credential_id": "",
  "sam_template": "",
    ...

Contoh Jenkinsfile:

pipeline {
  agent any
  environment {
    PIPELINE_USER_CREDENTIAL_ID = '{{cookiecutter.pipeline_user_jenkins_credential_id}}'
    SAM_TEMPLATE = '{{cookiecutter.sam_template}}'
    ...