Apa itu koneksi?

Anda dapat menggunakan fitur koneksi di konsol Alat Pengembang untuk menghubungkan AWS sumber daya seperti AWS CodePipeline ke repositori kode eksternal. Fitur ini memiliki API sendiri, referensi AWS CodeStar Connections API. Setiap koneksi adalah sumber daya yang dapat Anda berikan ke AWS layanan untuk terhubung ke repositori pihak ketiga, seperti. BitBucket Misalnya, Anda dapat menambahkan koneksi CodePipeline sehingga memicu pipeline Anda saat perubahan kode dilakukan ke repositori kode pihak ketiga Anda. Setiap koneksi diberi nama dan dikaitkan dengan Amazon Resource Name (ARN) unik yang digunakan untuk mereferensikan koneksi tersebut.

Apa yang bisa saya lakukan dengan koneksi?

Anda dapat menggunakan koneksi untuk mengintegrasikan sumber daya penyedia pihak ketiga dengan sumber AWS daya Anda di alat pengembang, termasuk:

• Connect ke penyedia pihak ketiga, seperti Bitbucket, dan gunakan koneksi pihak ketiga sebagai integrasi sumber dengan sumber AWS daya Anda, seperti CodePipeline.

• Kelola akses ke koneksi Anda secara seragam di seluruh sumber daya Anda dalam CodeBuild membangun proyek, CodeDeploy aplikasi, dan saluran pipa CodePipeline untuk penyedia pihak ketiga Anda.

• Gunakan ARN koneksi di templat tumpukan Anda untuk CodeBuild membangun proyek, CodeDeploy aplikasi, dan saluran pipa CodePipeline, tanpa perlu mereferensikan rahasia atau parameter yang tersimpan.

Untuk penyedia pihak ketiga apa saya dapat membuat koneksi?

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

• Bitbucket Cloud

• GitHub

• GitHub Awan Perusahaan

• GitHub Server Perusahaan

• GitLab

• GitLab instalasi yang dikelola sendiri (untuk Edisi Perusahaan atau Edisi Komunitas)

Untuk gambaran umum tentang alur kerja koneksi, lihat Alur kerja untuk membuat atau memperbarui koneksi.

Langkah-langkah untuk membuat koneksi untuk jenis penyedia cloud, seperti GitHub, berbeda dari langkah-langkah untuk jenis penyedia yang diinstal, seperti GitHub Enterprise Server. Untuk langkah-langkah tingkat tinggi guna membuat koneksi menurut jenis penyedia, lihat Bekerja dengan koneksi.

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.

Apa yang Layanan AWS terintegrasi dengan koneksi?

Anda dapat menggunakan koneksi untuk mengintegrasikan repositori pihak ketiga Anda dengan yang lain. Layanan AWS Untuk melihat integrasi layanan untuk koneksi, lihatIntegrasi produk dan layanan dengan Koneksi AWS CodeStar .

Bagaimana koneksi bekerja?

Sebelum Anda dapat membuat koneksi, Anda harus terlebih dahulu menginstal, atau memberikan akses ke, aplikasi AWS otentikasi di akun pihak ketiga Anda. Setelah koneksi diinstal, itu dapat diperbarui untuk menggunakan instalasi ini. Saat Anda membuat koneksi, Anda memberikan akses ke AWS sumber daya di akun pihak ketiga Anda. Ini memungkinkan koneksi untuk mengakses konten, seperti repositori sumber, di akun pihak ketiga, atas nama sumber daya Anda AWS . Anda kemudian dapat membagikan koneksi itu dengan orang lain Layanan AWS untuk menyediakan koneksi OAuth yang aman antar sumber daya.

Jika Anda ingin membuat sambungan ke jenis penyedia yang diinstal, seperti GitHub Enterprise Server, pertama-tama Anda membuat sumber daya host menggunakan AWS Management Console.

Koneksi dimiliki oleh Akun AWS yang menciptakannya. Koneksi diidentifikasi oleh ARN yang berisi ID koneksi. ID koneksi adalah UUID yang tidak dapat diubah atau dipetakan ulang. Menghapus dan membangun kembali koneksi menghasilkan ID koneksi baru, dan oleh karena itu ARN koneksi baru. Ini berarti bahwa koneksi ARN tidak pernah digunakan kembali.

Koneksi yang baru dibuat berada dalam status Pending. Proses jabat tangan (aliran OAuth) pihak ketiga diperlukan untuk menyelesaikan penyiapan koneksi dan untuk berpindah dari status Pending ke Available. Setelah ini selesai, koneksi adalah Available dan dapat digunakan dengan AWS layanan, seperti CodePipeline.

Host yang baru dibuat berada dalam status Pending. Proses pendaftaran pihak ketiga diperlukan untuk menyelesaikan penyiapan host dan untuk berpindah dari status Pending ke Available. Setelah ini selesai, host Available dan dapat digunakan untuk koneksi ke jenis penyedia yang diinstal.

Untuk gambaran umum tentang alur kerja koneksi, lihat Alur kerja untuk membuat atau memperbarui koneksi. Untuk ikhtisar alur kerja pembuatan host untuk penyedia yang diinstal, lihatAlur kerja untuk membuat atau memperbarui host. Untuk langkah-langkah tingkat tinggi guna membuat koneksi menurut jenis penyedia, lihat Bekerja dengan koneksi.

Sumber daya global dalam AWS CodeStar Koneksi

Koneksi adalah sumber daya global, yang berarti bahwa sumber daya direplikasi di semua Wilayah AWS.

Meskipun format ARN koneksi mencerminkan nama Wilayah tempatnya dibuat, sumber daya tidak dibatasi ke Wilayah mana pun. Wilayah tempat sumber daya koneksi dibuat adalah Wilayah tempat pembaruan data sumber daya koneksi dikendalikan. Contoh operasi API yang mengendalikan pembaruan ke data sumber daya koneksi termasuk membuat koneksi, memperbarui penginstalan, menghapus koneksi, atau menandai koneksi.

Sumber daya host untuk koneksi bukanlah sumber daya yang tersedia secara global. Anda menggunakan sumber daya host hanya di Wilayah tempat mereka dibuat.

• Anda hanya perlu membuat koneksi sekali, dan kemudian Anda dapat menggunakannya di mana saja Wilayah AWS.

• Jika Wilayah tempat koneksi dibuat mengalami masalah, ini memengaruhi API yang mengendalikan data sumber daya koneksi, namun Anda masih dapat berhasil menggunakan koneksi di setiap Wilayah lainnya.

• Ketika Anda mencantumkan sumber daya koneksi di konsol atau CLI, daftar tersebut menampilkan semua sumber daya koneksi yang terkait dengan akun Anda di semua Wilayah.

• Ketika Anda mencantumkan sumber daya host di konsol atau CLI, daftar tersebut menampilkan sumber daya host yang terkait dengan akun Anda hanya di Wilayah yang dipilih.

• Ketika koneksi dengan sumber daya host terkait terdaftar atau dilihat dengan CLI, output mengembalikan ARN host terlepas dari Wilayah CLI yang dikonfigurasi.

Alur kerja untuk membuat atau memperbarui host

Saat Anda membuat koneksi untuk penyedia yang diinstal, Anda terlebih dahulu membuat host.

Host dapat memiliki status berikut:

• Pending- pending Host adalah host yang telah dibuat dan harus diatur (dipindahkan keavailable) sebelum dapat digunakan.

• Available- Anda dapat menggunakan atau meneruskan available host ke koneksi Anda.

Alur Kerja: Membuat atau memperbarui host dengan CLI, SDK, atau AWS CloudFormation

Anda menggunakan CreateHostAPI untuk membuat host menggunakan AWS Command Line Interface (AWS CLI), SDK, atau AWS CloudFormation. Setelah dibuat, tuan rumah dalam pending keadaan. Anda menyelesaikan proses dengan menggunakan opsi Pengaturan konsol di konsol.

Alur kerja: Membuat atau memperbarui host dengan konsol

Jika Anda membuat sambungan ke jenis penyedia yang diinstal, seperti Server GitHub Perusahaan atau GitLab dikelola sendiri, Anda terlebih dahulu membuat host. Jika Anda terhubung ke jenis penyedia cloud, seperti Bitbucket, Anda melewatkan pembuatan host dan melanjutkan membuat koneksi.

Gunakan konsol untuk mengatur host dan mengubah statusnya dari pending keavailable.

Alur kerja untuk membuat atau memperbarui koneksi

Ketika Anda membuat koneksi, Anda juga membuat atau menggunakan penginstalan yang sudah ada untuk jabat tangan auth dengan penyedia pihak ketiga.

Koneksi dapat memiliki status berikut:

• Pending - Koneksi pending adalah koneksi yang harus diselesaikan (dipindahkan ke available) sebelum dapat digunakan.

• Available - Anda dapat menggunakan atau meneruskan koneksi available ke sumber daya dan pengguna lain di akun Anda.

• Error - Koneksi yang memiliki status error akan dicoba ulang secara otomatis. Itu tidak dapat digunakan sampai available.

Alur Kerja: Membuat atau memperbarui koneksi dengan CLI, SDK, atau AWS CloudFormation

Anda menggunakan CreateConnectionAPI untuk membuat koneksi menggunakan AWS Command Line Interface (AWS CLI), SDK, atau AWS CloudFormation. Setelah dibuat, koneksi berada dalam status pending. Anda menyelesaikan proses dengan menggunakan opsi konsol Siapkan koneksi yang tertunda. Konsol meminta Anda untuk membuat instalasi atau menggunakan instalasi yang sudah ada untuk koneksi. Anda kemudian menggunakan konsol untuk menyelesaikan jabat tangan dan memindahkan koneksi ke status available dengan memilih Selesaikan koneksi di konsol.

Alur kerja: Membuat atau memperbarui koneksi dengan konsol

Jika Anda membuat koneksi ke jenis penyedia yang diinstal, seperti GitHub Enterprise Server, Anda terlebih dahulu membuat host. Jika Anda terhubung ke jenis penyedia cloud, seperti Bitbucket, Anda melewatkan pembuatan host dan melanjutkan membuat koneksi.

Untuk membuat atau memperbarui koneksi menggunakan konsol, Anda menggunakan halaman tindakan CodePipeline edit di konsol untuk memilih penyedia pihak ketiga Anda. Konsol meminta Anda untuk membuat instalasi atau menggunakan instalasi yang sudah ada untuk koneksi, dan kemudian menggunakan konsol untuk membuat koneksi. Konsol menyelesaikan jabat tangan dan memindahkan koneksi dari status pending ke available secara otomatis.

Bagaimana saya memulai dengan koneksi?

Untuk memulai, berikut adalah beberapa topik yang berguna untuk ditinjau:

• Mempelajari tentang konsep untuk koneksi.

• Menyiapkan sumber daya yang Anda butuhkan untuk mulai bekerja dengan koneksi.

• Memulai dengan koneksi pertama Anda dan menghubungkannya ke sumber daya.