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

Referensi model integrasi

Ada beberapa integrasi pra-bangun untuk layanan pihak ketiga untuk membantu membangun alat pelanggan yang ada ke dalam proses rilis pipeline. Mitra, atau penyedia layanan pihak ketiga, menggunakan model integrasi untuk mengimplementasikan jenis tindakan untuk digunakan di CodePipeline.

Gunakan referensi ini saat Anda merencanakan atau bekerja dengan jenis tindakan yang dikelola dengan model integrasi yang didukung di CodePipeline.

Untuk mengesahkan jenis tindakan pihak ketiga Anda sebagai integrasi mitra CodePipeline, rujuk Jaringan Mitra AWS (APN). Informasi ini merupakan suplemen untuk AWS CLI Referensi.

Bagaimana jenis tindakan pihak ketiga bekerja dengan integrator

Anda dapat menambahkan jenis tindakan pihak ketiga ke pipeline pelanggan untuk menyelesaikan tugas pada sumber daya pelanggan. Integrator mengelola permintaan pekerjaan dan menjalankan tindakan dengannya CodePipeline. Diagram berikut menunjukkan jenis tindakan pihak ketiga yang dibuat untuk digunakan pelanggan dalam pipeline mereka. Setelah pelanggan mengonfigurasi tindakan, tindakan berjalan dan membuat permintaan pekerjaan yang ditangani oleh mesin tindakan integrator.

Diagram menunjukkan langkah-langkah berikut:

Untuk informasi tentang langkah-langkah yang dapat Anda gunakan untuk meminta, melihat, dan memperbarui jenis tindakan, lihatBekerja dengan jenis tindakan.

Konsep

Bagian ini menggunakan istilah berikut untuk jenis tindakan pihak ketiga:

Model integrasi yang didukung

CodePipeline memiliki dua model integrasi:

Sebagai perbandingan, tabel berikut menjelaskan fitur dari dua model:

Model integrasi Lambda

Model integrasi Lambda yang didukung termasuk membuat fungsi Lambda dan menentukan output untuk jenis tindakan pihak ketiga.

Perbarui fungsi Lambda Anda untuk menangani input dari CodePipeline

Anda dapat membuat fungsi Lambda baru. Anda dapat menambahkan logika bisnis ke fungsi Lambda yang dijalankan setiap kali ada pekerjaan yang tersedia di pipeline untuk jenis tindakan Anda. Misalnya, mengingat konteks pelanggan dan pipeline, Anda mungkin ingin memulai membangun layanan Anda untuk pelanggan.

Gunakan parameter berikut untuk memperbarui fungsi Lambda Anda untuk menangani input dari CodePipeline.

Format:

Tipe data:

Contoh:

{
    "jobId": "01234567-abcd-abcd-abcd-012345678910",
    "accountId": "012345678910",
    "data": {
        "actionConfiguration": {
            "key1": "value1",
            "key2": "value2"
        },
        "encryptionKey": {
            "id": "123-abc",
            "type": "KMS"
        },
        "inputArtifacts": [
            {
                "name": "input-art-name",
                "location": {
                    "type": "S3",
                    "s3Location": {
                        "bucketName": "inputBucket",
                        "objectKey": "inputKey"
                    }
                }
            }
        ],
        "outputArtifacts": [
            {
                "name": "output-art-name",
                "location": {
                    "type": "S3",
                    "s3Location": {
                        "bucketName": "outputBucket",
                        "objectKey": "outputKey"
                    }
                }
            }
        ],
        "actionExecutionId": "actionExecutionId",
        "actionCredentials": {
            "accessKeyId": "access-id",
            "secretAccessKey": "secret-id",
            "sessionToken": "session-id"
        },
        "continuationToken": "continueId-xxyyzz"
    }
}

Kembalikan hasil dari fungsi Lambda Anda ke CodePipeline

Sumber daya pekerja pekerjaan integrator harus mengembalikan muatan yang valid dalam kasus keberhasilan, kegagalan, atau kelanjutan.

Format:

Contoh:

{
    "result": "success",
    "failureType": null,
    "continuation": null,
    "status": {
        "externalExecutionId": "my-commit-id-123",
        "summary": "everything is dandy"
    },
    "outputVariables": {
        "FirstOne": "Nice",
        "SecondOne": "Nicest",
        ...
    }        
}

Gunakan token lanjutan untuk menunggu hasil dari proses asinkron

continuationToken adalah bagian dari payload dan hasil dari fungsi Lambda Anda. Ini adalah cara untuk meneruskan status pekerjaan ke CodePipeline dan menunjukkan bahwa pekerjaan perlu dilanjutkan. Misalnya, setelah integrator memulai build untuk pelanggan pada sumber daya mereka, itu tidak menunggu build selesai, tetapi menunjukkan CodePipeline bahwa ia tidak memiliki hasil terminal dengan mengembalikan result as continue dan mengembalikan ID unik build ke CodePipeline sebagai continuation token.

CodePipeline Tim memanggil integrator setelah 30 detik dengan continuation token yang sama dalam payloadnya sehingga dapat memeriksa penyelesaiannya. Jika build selesai, integrator mengembalikan success/fail hasil terminal, jika tidak melanjutkan.

Ber CodePipeline ikan izin untuk memanggil fungsi integrator Lambda saat runtime

Anda menambahkan izin ke fungsi integrator Lambda Anda untuk menyediakan CodePipeline layanan dengan izin untuk memanggilnya menggunakan prinsip CodePipeline layanan:. codepipeline.amazonaws.com Anda dapat menambahkan izin dengan menggunakan CloudFormation atau baris perintah. Sebagai contoh, lihat Bekerja dengan jenis tindakan.

Model integrasi pekerja kerja

Setelah Anda merancang alur kerja tingkat tinggi Anda, Anda dapat membuat pekerja pekerjaan Anda. Meskipun spesifik tindakan pihak ketiga menentukan apa yang diperlukan untuk pekerja kerja, sebagian besar pekerja pekerjaan untuk tindakan pihak ketiga mencakup fungsionalitas berikut:

Memilih dan mengonfigurasi strategi manajemen izin untuk pekerja pekerjaan Anda

Untuk mengembangkan pekerja pekerjaan untuk tindakan pihak ketiga Anda CodePipeline, Anda memerlukan strategi untuk integrasi pengguna dan manajemen izin.

Strategi paling sederhana adalah menambahkan infrastruktur yang Anda butuhkan untuk pekerja kerja Anda dengan membuat instans Amazon EC2 dengan peran instans AWS Identity and Access Management (IAM), yang memungkinkan Anda meningkatkan sumber daya yang Anda butuhkan untuk integrasi dengan mudah. Anda dapat menggunakan integrasi bawaan AWS untuk menyederhanakan interaksi antara pekerja kerja Anda dan CodePipeline.

Pelajari lebih lanjut tentang Amazon EC2 dan tentukan apakah itu pilihan yang tepat untuk integrasi Anda. Untuk informasi, lihat Amazon EC2 - Hosting Server Virtual. Untuk informasi tentang menyiapkan instans Amazon EC2, lihat Mem ulai dengan Instans Linux Amazon EC2.

Strategi lain yang perlu dipertimbangkan adalah menggunakan federasi identitas dengan IAM untuk mengintegrasikan sistem dan sumber daya penyedia identitas Anda yang ada. Strategi ini berguna jika Anda sudah memiliki penyedia identitas perusahaan atau sudah dikonfigurasi untuk mendukung pengguna menggunakan penyedia identitas web. Federasi identitas memungkinkan Anda untuk memberikan akses aman ke AWS sumber daya, termasuk CodePipeline, tanpa harus membuat atau mengelola pengguna IAM. Anda dapat menggunakan fitur dan kebijakan untuk persyaratan keamanan kata sandi dan rotasi kredensia. Anda dapat menggunakan contoh aplikasi sebagai templat untuk desain Anda sendiri. Untuk selengkapnya, lihat M engelola Federasi.

Untuk memberikan akses dan menambahkan izin bagi pengguna, grup, atau peran Anda:

Berikut ini adalah contoh kebijakan yang mungkin Anda buat untuk digunakan dengan pekerja pekerjaan pihak ketiga Anda. Kebijakan ini dimaksudkan sebagai contoh saja dan disediakan apa adanya.

JSON

{
  "Version":"2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "codepipeline:PollForThirdPartyJobs",
        "codepipeline:AcknowledgeThirdPartyJob",
        "codepipeline:GetThirdPartyJobDetails",
        "codepipeline:PutThirdPartyJobSuccessResult",
        "codepipeline:PutThirdPartyJobFailureResult"
      ],
      "Resource": [
        "arn:aws:codepipeline:us-east-2::actionType:ThirdParty/Build/Provider/1/"  
      ]              
    }
  ]
}