Apa itu koneksi? - Konsol Alat Developer

Apa itu koneksi?

Anda dapat menggunakan fitur koneksi di konsol Alat Developer untuk menghubungkan sumber daya AWS seperti AWS CodePipeline ke repositori kode eksternal. Fitur ini memiliki API sendiri, Referensi API AWS CodeStar Connections. Setiap koneksi adalah sumber daya yang dapat Anda berikan ke layanan AWS untuk terhubung ke repositori pihak ketiga, seperti BitBucket. Misalnya, Anda dapat menambahkan koneksi di CodePipeline sehingga memicu alur Anda ketika perubahan kode dibuat 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 daya AWS Anda di alat developer, termasuk:

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

  • Secara seragam mengelola akses ke koneksi Anda di seluruh sumber daya Anda dalam proyek pembangunan CodeBuild, aplikasi CodeDeploy, dan alur di CodePipeline untuk penyedia pihak ketiga Anda.

  • Gunakan koneksi ARN dalam templat tumpukan Anda proyek pembangunan CodeBuild, aplikasi CodeDeploy, dan alur di CodePipeline, tanpa perlu mereferensi rahasia atau parameter yang disimpan.

Penyedia Pihak Ketiga Apa yang Dapat Saya Dapat Buat Koneksinya?

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

  • Bitbucket Cloud

  • GitHub

  • GitHub Enterprise Cloud

  • GitHub Enterprise Server

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

Langkah-langkah untuk membuat koneksi bagi jenis penyedia cloud, seperti GitHub, berbeda dengan 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.

Layanan AWS Apa yang Terintegrasi Dengan Koneksi?

Anda dapat menggunakan koneksi untuk mengintegrasikan repositori pihak ketiga Anda dengan layanan AWS berikut:

  • Amazon CodeGuru Reviewer

  • AWS CodePipeline

Bagaimana koneksi bekerja?

Sebelum Anda dapat membuat koneksi, Anda harus terlebih dahulu menginstal, atau memberikan akses ke, aplikasi autentikasi AWS pada akun pihak ketiga Anda. Setelah koneksi diinstal, itu dapat diperbarui untuk menggunakan instalasi ini. Saat Anda membuat koneksi, Anda memberikan akses ke sumber daya AWS di akun pihak ketiga Anda. Hal ini memungkinkan koneksi untuk mengakses konten, seperti repositori sumber, di akun pihak ketiga, atas nama sumber daya AWS Anda. Anda kemudian dapat membagikan koneksi tersebut dengan layanan AWS lainnya untuk menyediakan koneksi OAuth yang aman di antara sumber daya.

Jika Anda ingin membuat koneksi ke jenis penyedia yang diinstal, seperti GitHub Enterprise Server, Anda terlebih dahulu membuat sumber daya host menggunakan file AWS Management Console.


        Diagram yang menampilkan koneksi antara sumber daya AWS dan repositori pihak ketiga menggunakan koneksi ARN.

Koneksi dimiliki oleh akun AWS yang menciptakan mereka. 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 Available dan dapat digunakan dengan layanan AWS, 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 langkah-langkah tingkat tinggi guna membuat koneksi menurut jenis penyedia, lihat Bekerja dengan koneksi.

Sumber daya global di Koneksi AWS CodeStar

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 Wilayah AWS mana pun.

  • 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 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 API CreateConnection 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 harus membuat host terlebih dahulu. 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 edit CodePipeline pada 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.


          Diagram yang menampilkan alur kerja pembuatan koneksi ke penyedia pihak ketiga.

Bagaimana saya memulai dengan koneksi?

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