CodeStarSourceConnection untuk Bitbucket Cloud, GitHub Enterprise Server GitHub, GitLab .com, dan tindakan yang dikelola GitLab sendiri - AWS CodePipeline

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

CodeStarSourceConnection untuk Bitbucket Cloud, GitHub Enterprise Server GitHub, GitLab .com, dan tindakan yang dikelola GitLab sendiri

Tindakan sumber untuk koneksi didukung oleh AWS CodeConnections. CodeConnections memungkinkan Anda untuk membuat dan mengelola koneksi antara AWS sumber daya dan repositori pihak ketiga seperti. GitHub Memulai pipeline saat komit baru dibuat pada repositori kode sumber pihak ketiga. Tindakan sumber mengambil perubahan kode saat pipeline dijalankan secara manual atau saat peristiwa webhook dikirim dari penyedia sumber.

Anda dapat mengonfigurasi tindakan dalam pipeline Anda untuk menggunakan konfigurasi Git yang memungkinkan Anda memulai pipeline dengan pemicu. Untuk mengonfigurasi konfigurasi pemicu pipeline untuk memfilter dengan pemicu, lihat detail selengkapnya diFilter pemicu pada permintaan push atau pull kode.

catatan

Fitur ini tidak tersedia di Asia Pasifik (Hong Kong), Asia Pasifik (Hyderabad), Asia Pasifik (Jakarta), Asia Pasifik (Melbourne), Asia Pasifik (Osaka), Afrika (Cape Town), Timur Tengah (Bahrain), Timur Tengah (UEA), Eropa (Spanyol), Eropa (Zurich), Israel (Tel Aviv), atau (AS-Barat) Wilayah. AWS GovCloud Untuk mereferensikan tindakan lain yang tersedia, lihatIntegrasi produk dan layanan dengan CodePipeline. Untuk pertimbangan dengan tindakan ini di Wilayah Eropa (Milan), lihat catatan diCodeStarSourceConnection untuk Bitbucket Cloud, GitHub Enterprise Server GitHub, GitLab .com, dan tindakan yang dikelola GitLab sendiri.

Koneksi dapat mengaitkan AWS sumber daya Anda dengan repositori pihak ketiga berikut:

  • Bitbucket Cloud (melalui opsi penyedia Bitbucket di CodePipeline konsol atau Bitbucket penyedia di CLI)

    catatan

    Anda dapat membuat koneksi ke repositori Bitbucket Cloud. Jenis penyedia Bitbucket yang diinstal, seperti Bitbucket Server, tidak didukung.

  • catatan

    Jika Anda menggunakan ruang kerja Bitbucket, Anda harus memiliki akses administrator untuk membuat koneksi.

  • GitHub dan GitHub Enterprise Cloud (melalui opsi penyedia GitHub (Versi 2) di CodePipeline konsol atau GitHub penyedia di CLI)

    catatan

    Jika repositori Anda ada di GitHub organisasi, Anda harus menjadi pemilik organisasi untuk membuat koneksi. Jika Anda menggunakan repositori yang tidak ada dalam organisasi, Anda harus menjadi pemilik repositori.

  • GitHub Server Perusahaan (melalui opsi penyedia Server GitHub Perusahaan di CodePipeline konsol atau GitHub Enterprise Server penyedia di CLI)

  • GitLab.com (melalui opsi GitLabpenyedia di CodePipeline konsol atau GitLab penyedia di CLI)

    catatan

    Anda dapat membuat koneksi ke repositori tempat Anda memiliki peran Pemilik GitLab, dan kemudian koneksi dapat digunakan dengan repositori dengan sumber daya seperti. CodePipeline Untuk repositori dalam grup, Anda tidak perlu menjadi pemilik grup.

  • Instalasi yang dikelola sendiri untuk GitLab (Edisi Perusahaan atau Edisi Komunitas) (melalui opsi penyedia yang GitLab dikelola sendiri di CodePipeline konsol atau GitLabSelfManaged penyedia di CLI)

catatan

Setiap koneksi mendukung semua repositori yang Anda miliki dengan penyedia itu. Anda hanya perlu membuat koneksi baru untuk setiap jenis penyedia.

Koneksi memungkinkan pipeline Anda mendeteksi perubahan sumber melalui aplikasi penginstalan penyedia pihak ketiga. Misalnya, webhook digunakan untuk berlangganan jenis GitHub acara dan dapat diinstal pada organisasi, repositori, atau Aplikasi. GitHub Koneksi Anda menginstal webhook repositori di GitHub Aplikasi Anda yang berlangganan peristiwa jenis push. GitHub

Setelah perubahan kode terdeteksi, Anda memiliki opsi berikut untuk meneruskan kode ke tindakan selanjutnya:

  • Default: Seperti tindakan CodePipeline sumber lain yang ada, CodeStarSourceConnection dapat menampilkan file ZIP dengan salinan dangkal dari komit Anda.

  • Klon lengkap: juga CodeStarSourceConnection dapat dikonfigurasi untuk menampilkan referensi URL ke repo untuk tindakan selanjutnya.

    Saat ini, referensi URL Git hanya dapat digunakan oleh CodeBuild tindakan hilir untuk mengkloning repo dan metadata Git terkait. Mencoba meneruskan referensi URL Git ke CodeBuild non-tindakan menghasilkan kesalahan.

CodePipeline meminta Anda untuk menambahkan aplikasi penginstalan AWS Konektor ke akun pihak ketiga saat Anda membuat koneksi. Anda harus sudah membuat akun dan repositori penyedia pihak ketiga Anda sebelum Anda dapat terhubung melalui tindakan. CodeStarSourceConnection

catatan

Untuk membuat atau melampirkan kebijakan ke peran Anda dengan izin yang diperlukan untuk menggunakan AWS CodeStar koneksi, lihat Referensi izin koneksi. Bergantung pada kapan peran CodePipeline layanan dibuat, Anda mungkin perlu memperbarui izinnya untuk mendukung AWS CodeStar koneksi. Untuk petunjuk, lihat Menambahkan izin ke peran CodePipeline layanan.

catatan

Untuk menggunakan koneksi di Eropa (Milan) Wilayah AWS, Anda harus:

  1. Instal aplikasi khusus Wilayah

  2. Aktifkan Wilayah

Aplikasi khusus Wilayah ini mendukung koneksi di Wilayah Eropa (Milan). Ini diterbitkan di situs penyedia pihak ketiga, dan terpisah dari aplikasi yang ada yang mendukung koneksi untuk Wilayah lain. Dengan menginstal aplikasi ini, Anda memberi wewenang kepada penyedia pihak ketiga untuk membagikan data Anda dengan layanan untuk Wilayah ini saja, dan Anda dapat mencabut izin kapan saja dengan mencopot pemasangan aplikasi.

Layanan tidak akan memproses atau menyimpan data Anda kecuali Anda mengaktifkan Wilayah. Dengan mengaktifkan Wilayah ini, Anda memberikan izin layanan kami untuk memproses dan menyimpan data Anda.

Meskipun Wilayah tidak diaktifkan, penyedia pihak ketiga masih dapat membagikan data Anda dengan layanan kami jika aplikasi khusus Wilayah tetap diinstal, jadi pastikan untuk menghapus instalan aplikasi setelah Anda menonaktifkan Wilayah. Untuk informasi selengkapnya, lihat Mengaktifkan Wilayah.

Tipe tindakan

  • Kategori: Source

  • Pemilik: AWS

  • Penyedia: CodeStarSourceConnection

  • Versi: 1

Parameter konfigurasi

ConnectionArn

Wajib: Ya

Koneksi ARN yang dikonfigurasi dan diautentikasi untuk penyedia sumber.

FullRepositoryId

Wajib: Ya

Pemilik dan nama repositori tempat perubahan sumber akan dideteksi.

Contoh: some-user/my-repo

penting

Anda harus mempertahankan kasus yang benar untuk FullRepositoryIdnilainya. Misalnya, jika nama pengguna Anda some-user dan nama repo adalahMy-Repo, nilai yang disarankan FullRepositoryIdadalahsome-user/My-Repo.

BranchName

Wajib: Ya

Nama cabang tempat perubahan sumber harus dideteksi.

OutputArtifactFormat

Wajib: Tidak

Menentukan format artefak keluaran. Bisa salah satu CODEBUILD_CLONE_REF atauCODE_ZIP. Jika tidak ditentukan, defaultnya adalahCODE_ZIP.

penting

CODEBUILD_CLONE_REFOpsi ini hanya dapat digunakan oleh tindakan CodeBuild hilir.

Jika Anda memilih opsi ini, Anda perlu memperbarui izin untuk peran layanan CodeBuild proyek Anda seperti yang ditunjukkan padaTambahkan CodeBuild GitClone izin untuk koneksi ke Bitbucket,, GitHub Enterprise Server GitHub, atau .com GitLab. Untuk tutorial yang menunjukkan cara menggunakan opsi klon Penuh, lihatTutorial: Gunakan klon lengkap dengan sumber GitHub pipa.

DetectChanges

Wajib: Tidak

Kontrol secara otomatis memulai pipeline Anda ketika komit baru dibuat pada repositori dan cabang yang dikonfigurasi. Jika tidak ditentukan, nilai defaultnya adalahtrue, dan bidang tidak ditampilkan secara default. Nilai yang valid untuk parameter ini:

  • true: CodePipeline secara otomatis memulai pipeline Anda pada komit baru.

  • false: CodePipeline tidak memulai pipeline Anda pada komit baru.

Artefak masukan

  • Jumlah artefak: 0

  • Deskripsi: Artefak masukan tidak berlaku untuk jenis tindakan ini.

Artefak keluaran

  • Jumlah artefak: 1

  • Deskripsi: Artefak yang dihasilkan dari repositori adalah artefak keluaran untuk tindakan tersebut. CodeStarSourceConnection ID komit kode sumber ditampilkan CodePipeline sebagai revisi sumber untuk eksekusi pipeline yang dipicu. Anda dapat mengonfigurasi artefak keluaran dari tindakan ini di:

    • File ZIP yang berisi isi repositori dan cabang yang dikonfigurasi pada komit yang ditentukan sebagai revisi sumber untuk eksekusi pipeline.

    • File JSON yang berisi referensi URL ke repositori sehingga tindakan hilir dapat melakukan perintah Git secara langsung.

      penting

      Opsi ini hanya dapat digunakan oleh tindakan CodeBuild hilir.

      Jika Anda memilih opsi ini, Anda perlu memperbarui izin untuk peran layanan CodeBuild proyek Anda seperti yang ditunjukkan padaPemecahan masalah CodePipeline. Untuk tutorial yang menunjukkan cara menggunakan opsi klon Penuh, lihatTutorial: Gunakan klon lengkap dengan sumber GitHub pipa.

Variabel keluaran

Ketika dikonfigurasi, tindakan ini menghasilkan variabel yang dapat direferensikan oleh konfigurasi tindakan tindakan hilir dalam pipeline. Tindakan ini menghasilkan variabel yang dapat dilihat sebagai variabel keluaran, bahkan jika tindakan tidak memiliki namespace. Anda mengonfigurasi tindakan dengan namespace untuk membuat variabel-variabel tersebut tersedia untuk konfigurasi tindakan hilir.

Untuk informasi selengkapnya, lihat Variabel.

AuthorDate

Tanggal ketika komit ditulis, dalam format stempel waktu.

BranchName

Nama cabang untuk repositori tempat perubahan sumber dilakukan.

CommitId

ID komit yang memicu eksekusi pipeline.

CommitMessage

Pesan deskripsi, jika ada, terkait dengan komit yang memicu eksekusi pipeline.

ConnectionArn

Koneksi ARN yang dikonfigurasi dan diautentikasi untuk penyedia sumber.

FullRepositoryName

Nama repositori tempat komit yang memicu pipeline dibuat.

Deklarasi tindakan

Dalam contoh berikut, artefak keluaran diatur ke format ZIP default CODE_ZIP untuk koneksi dengan ARNarn:aws:codestar-connections:region:account-id:connection/connection-id.

YAML
Name: Source Actions: - InputArtifacts: [] ActionTypeId: Version: '1' Owner: AWS Category: Source Provider: CodeStarSourceConnection OutputArtifacts: - Name: SourceArtifact RunOrder: 1 Configuration: ConnectionArn: "arn:aws:codestar-connections:region:account-id:connection/connection-id" FullRepositoryId: "some-user/my-repo" BranchName: "main" OutputArtifactFormat: "CODE_ZIP" Name: ApplicationSource
JSON
{ "Name": "Source", "Actions": [ { "InputArtifacts": [], "ActionTypeId": { "Version": "1", "Owner": "AWS", "Category": "Source", "Provider": "CodeStarSourceConnection" }, "OutputArtifacts": [ { "Name": "SourceArtifact" } ], "RunOrder": 1, "Configuration": { "ConnectionArn": "arn:aws:codestar-connections:region:account-id:connection/connection-id", "FullRepositoryId": "some-user/my-repo", "BranchName": "main", "OutputArtifactFormat": "CODE_ZIP" }, "Name": "ApplicationSource" } ] },

Menginstal aplikasi instalasi dan membuat koneksi

Pertama kali Anda menggunakan konsol untuk menambahkan koneksi baru ke repositori pihak ketiga, Anda harus mengotorisasi CodePipeline akses ke repositori Anda. Anda memilih atau membuat aplikasi instalasi yang membantu Anda terhubung ke akun tempat Anda membuat repositori kode pihak ketiga.

Ketika Anda menggunakan AWS CLI atau AWS CloudFormation template, Anda harus menyediakan koneksi ARN dari koneksi yang telah melalui jabat tangan instalasi. Jika tidak, pipa tidak dipicu.

catatan

Untuk tindakan CodeStarSourceConnection sumber, Anda tidak perlu menyiapkan webhook atau default ke polling. Tindakan koneksi mengelola deteksi perubahan sumber Anda untuk Anda.

Sumber daya terkait berikut dapat membantu Anda saat Anda bekerja dengan tindakan ini.

  • AWS::CodeStarConnections::Connection— Referensi AWS CloudFormation template untuk sumber daya AWS CodeStar Connections menyediakan parameter dan contoh untuk koneksi dalam AWS CloudFormation template.

  • AWS CodeStarReferensi API AWS CodeStar Koneksi — Referensi API Koneksi menyediakan informasi referensi untuk tindakan koneksi yang tersedia.

  • Untuk melihat langkah-langkah untuk membuat pipeline dengan tindakan sumber yang didukung oleh koneksi, lihat berikut ini:

    • Untuk Bitbucket Cloud, gunakan opsi Bitbucket di konsol atau CodestarSourceConnection tindakan di CLI. Lihat Koneksi Bitbucket Cloud.

    • Untuk GitHub dan GitHub Enterprise Cloud, gunakan opsi GitHubpenyedia di konsol atau CodestarSourceConnection tindakan di CLI. Lihat GitHub koneksi.

    • Untuk GitHub Enterprise Server, gunakan opsi penyedia GitHub Enterprise Server di konsol atau CodestarSourceConnection tindakan di CLI. Lihat GitHub Koneksi Enterprise Server.

    • GitLabUntuk.com, gunakan opsi GitLabpenyedia di konsol atau CodestarSourceConnection tindakan dengan GitLab penyedia di CLI. Lihat GitLabkoneksi .com.

  • Untuk melihat tutorial Memulai yang membuat pipeline dengan sumber Bitbucket dan CodeBuild tindakan, lihat Memulai koneksi.

  • Untuk tutorial yang menunjukkan cara menghubungkan ke GitHub repositori dan menggunakan opsi klon Penuh dengan tindakan hilir CodeBuild , lihat. Tutorial: Gunakan klon lengkap dengan sumber GitHub pipa