Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris. # GitLab Pelari yang dikelola sendiri di AWS CodeBuild GitLab menyediakan dua mode eksekusi untuk menjalankan GitLab pekerjaan di CI/CD pipeline Anda. Satu mode adalah GitLab -host runner, yang dikelola oleh GitLab dan terintegrasi penuh dengan. GitLab Mode lainnya adalah pelari yang dikelola sendiri, yang memungkinkan Anda membawa lingkungan khusus Anda sendiri untuk menjalankan pekerjaan di pipa GitLab CI/CD. Langkah-langkah tingkat tinggi untuk mengonfigurasi CodeBuild proyek untuk menjalankan pekerjaan pipa GitLab CI/CD adalah sebagai berikut: 1. Jika Anda belum melakukannya, sambungkan dengan OAuth aplikasi untuk menghubungkan proyek Anda GitLab. 1. Arahkan ke CodeBuild konsol dan buat CodeBuild proyek dengan webhook dan atur filter webhook Anda. 1. Perbarui saluran GitLab CI/CD YAMAL GitLab untuk mengonfigurasi lingkungan build Anda. Untuk prosedur yang lebih rinci, lihat[Tutorial: Konfigurasikan pelari yang CodeBuild di-host GitLab](sample-gitlab-runners.md). Fitur ini memungkinkan pekerjaan pipeline GitLab CI/CD Anda untuk mendapatkan integrasi asli AWS, yang memberikan keamanan dan kenyamanan melalui fitur seperti IAM,, AWS CloudTrail dan Amazon VPC. Anda dapat mengakses jenis instans terbaru, termasuk instance berbasis ARM. **Topics** + [Tentang pelari yang CodeBuild di-host GitLab](gitlab-runner-questions.md) + [Tutorial: Konfigurasikan pelari yang CodeBuild di-host GitLab](sample-gitlab-runners.md) + [Penggantian label didukung dengan pelari yang CodeBuild di-host GitLab](gitlab-runners-update-labels.md) + [Hitung gambar yang didukung dengan pelari yang CodeBuild di-host GitLab](sample-gitlab-runners-gitlab-ci.images.md) # Tentang pelari yang CodeBuild di-host GitLab Berikut ini adalah beberapa pertanyaan umum tentang GitLab pelari yang CodeBuild di-host. ## Jenis sumber apa yang didukung untuk GitLab pelari yang CodeBuild di-host? CodeBuild-host GitLab runner didukung untuk tipe `GITLAB` dan `GITLAB_SELF_MANAGED` sumber. ## Kapan saya harus menyertakan penggantian gambar dan instance di label? Anda dapat menyertakan penggantian gambar dan instance dalam label untuk menentukan lingkungan build yang berbeda untuk setiap pekerjaan pipeline GitLab CI/CD Anda. Ini dapat dilakukan tanpa perlu membuat beberapa CodeBuild proyek atau webhook. ## Bisakah saya gunakan CloudFormation untuk fitur ini? Ya, Anda dapat menyertakan grup filter dalam CloudFormation template Anda yang menentukan filter peristiwa pekerjaan GitLab alur kerja di webhook proyek Anda. ``` Triggers: Webhook: true FilterGroups: - - Type: EVENT Pattern: WORKFLOW_JOB_QUEUED ``` Untuk informasi selengkapnya, lihat [Filter acara GitLab webhook ()CloudFormation](gitlab-webhook-events-cfn.md). Jika Anda memerlukan bantuan untuk menyiapkan kredensil proyek di CloudFormation templat Anda, lihat [AWS::CodeBuild::SourceCredential](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-codebuild-sourcecredential.html)di *Panduan AWS CloudFormation Pengguna* untuk informasi selengkapnya. ## Bagaimana saya bisa menutupi rahasia saat menggunakan fitur ini? Secara default, rahasia yang dicetak di log tidak ditutupi. Jika Anda ingin menutupi rahasia Anda, Anda dapat melakukannya dengan memperbarui pengaturan variabel CI/CD lingkungan Anda: **Untuk menutupi rahasia di GitLab** 1. Di **GitLab Pengaturan** Anda, pilih **CI/CD**. 1. Di **Variabel**, pilih **Edit** untuk rahasia yang ingin Anda tutupi. 1. Di **Visibilitas**, pilih **Variabel topeng**, lalu pilih **Perbarui variabel** untuk menyimpan perubahan Anda. ## Dapatkah saya menerima acara GitLab webhook dari beberapa proyek dalam satu grup? CodeBuild mendukung webhook grup, yang menerima acara dari grup tertentu GitLab . Untuk informasi selengkapnya, lihat [GitLab kelompok webhooks](gitlab-group-webhook.md). ## Bisakah saya menjalankan pekerjaan di docker executor untuk pelari yang dikelola sendiri? Misalnya, saya ingin menjalankan pekerjaan pipeline pada gambar tertentu untuk mempertahankan lingkungan build yang sama dalam wadah terpisah dan terisolasi. Anda dapat menjalankan runner yang GitLab dikelola sendiri CodeBuild dengan gambar tertentu dengan [membuat proyek dengan gambar khusus atau mengganti gambar](create-project.md#environment-image.console) [di file](sample-gitlab-runners.md#sample-gitlab-runners-gitlab-ci) Anda. `.gitlab-ci.yml` ## Eksekutor apa yang dijalankan oleh pelari yang dikelola sendiri? CodeBuild Runner yang dikelola sendiri CodeBuild berjalan dengan eksekutor shell, di mana build berjalan secara lokal bersama dengan GitLab runner yang berjalan di dalam wadah docker. ## Bisakah saya memberikan perintah buildspec bersama dengan pelari yang dikelola sendiri? Ya, dimungkinkan untuk menambahkan perintah buildspec bersama dengan pelari yang dikelola sendiri. **Anda dapat menyediakan file buildspec.yl di GitLab repositori Anda dan menggunakan `buildspec-override:true` tag di bagian Tag pekerjaan.** Untuk informasi selengkapnya, lihat [Nama file Buildspec dan lokasi penyimpanan](build-spec-ref.md#build-spec-ref-name-storage). ## Wilayah mana yang mendukung penggunaan GitLab pelari yang CodeBuild di-host? CodeBuild GitLab -Pelari yang di-host didukung di semua CodeBuild wilayah. Untuk informasi selengkapnya tentang Wilayah AWS tempat CodeBuild tersedia, lihat [AWS Layanan menurut Wilayah](https://aws.amazon.com/about-aws/global-infrastructure/regional-product-services/). ## Platform mana yang mendukung penggunaan GitLab pelari yang CodeBuild di-host? CodeBuild GitLab -Pelari yang di-host didukung di Amazon [AWS Lambda](lambda.md)EC2 dan komputasi. Anda dapat menggunakan platform berikut: Amazon Linux 2, Amazon Linux 2023, Ubuntu, dan Windows Server Core 2019. Untuk informasi selengkapnya, lihat [Gambar komputasi EC2](ec2-compute-images.md) dan [Lambda menghitung gambar](lambda-compute-images.md). # Tutorial: Konfigurasikan pelari yang CodeBuild di-host GitLab Tutorial ini menunjukkan cara mengkonfigurasi CodeBuild proyek Anda untuk menjalankan pekerjaan pipa GitLab CI/CD. Untuk informasi selengkapnya tentang menggunakan GitLab atau Dikelola GitLab Sendiri dengan CodeBuild, lihat[GitLab Pelari yang dikelola sendiri di AWS CodeBuild](gitlab-runner.md). Untuk menyelesaikan tutorial ini, Anda harus terlebih dahulu: + Connect dengan OAuth aplikasi dengan menggunakan CodeConnections. Perhatikan bahwa saat menghubungkan dengan OAuth aplikasi, Anda harus menggunakan CodeBuild konsol untuk melakukannya. Untuk instruksi lebih lanjut, lihat[GitLab akses di CodeBuild](access-tokens-gitlab-overview.md). + Connect CodeBuild ke GitLab akun Anda. Untuk melakukannya, Anda dapat menambahkan GitLab sebagai penyedia sumber di konsol. Untuk petunjuk, lihat [GitLab akses di CodeBuild](access-tokens-gitlab-overview.md). **catatan** Ini hanya perlu dilakukan jika Anda belum terhubung ke GitLab akun Anda. Dengan fitur ini, CodeBuild perlu izin tambahan. seperti `create_runner` dan `manage_runner` dari aplikasi. GitLab OAuth Jika ada CodeConnections untuk GitLab akun tertentu, maka akun tersebut tidak secara otomatis meminta pembaruan izin. Untuk melakukannya, Anda dapat pergi ke CodeConnections konsol dan membuat koneksi dummy ke GitLab akun yang sama untuk memicu otorisasi ulang untuk mendapatkan izin tambahan. Dengan ini, semua koneksi yang ada dapat menggunakan fitur runner. Setelah selesai, Anda dapat menghapus koneksi dummy. ## Langkah 1: Buat CodeBuild proyek dengan webhook Pada langkah ini, Anda akan membuat CodeBuild proyek dengan webhook dan meninjaunya di GitLab konsol. **Untuk membuat CodeBuild proyek dengan webhook** 1. Buka AWS CodeBuild konsol di [https://console.aws.amazon.com/codesuite/codebuild/home](https://console.aws.amazon.com/codesuite/codebuild/home). 1. Buat proyek build. Untuk informasi selengkapnya, lihat [Buat proyek build (konsol)](create-project.md#create-project-console) dan [Jalankan build (konsol)](run-build-console.md). Pada **tipe Project**, pilih **Runner project**. + Di **Runner**: + Untuk **penyedia Runner**, pilih **GitLab**. + Untuk **Credential**, pilih salah satu dari berikut ini: + Pilih **Default source credential**. Koneksi default menerapkan GitLab koneksi default di semua proyek. + Pilih **Kredensi sumber kustom**. Koneksi kustom menerapkan GitLab koneksi kustom yang mengesampingkan pengaturan default akun Anda. **catatan** Jika Anda belum membuat koneksi ke penyedia Anda, Anda harus membuat GitLab koneksi baru. Untuk petunjuk, lihat [Connect CodeBuild ke GitLab](access-tokens-gitlab-overview.md#connections-gitlab). + Untuk **lokasi Runner**, pilih **Repository**. + Untuk **Repositori**, pilih nama proyek Anda GitLab dengan menentukan jalur proyek dengan namespace. + Di **Lingkungan**: + Pilih **gambar Lingkungan** yang didukung dan **Compute**. Perhatikan bahwa Anda memiliki opsi untuk mengganti pengaturan gambar dan instans dengan menggunakan label di YAMAL pipeline GitLab CI/CD Anda. Untuk informasi selengkapnya, lihat [Langkah 2: Buat file.gitlab-ci.yl di repositori Anda](#sample-gitlab-runners-gitlab-ci). + Di **Buildspec**: + Perhatikan bahwa buildspec Anda akan diabaikan kecuali `buildspec-override:true` ditambahkan sebagai label. Sebagai gantinya, CodeBuild akan menimpanya untuk menggunakan perintah yang akan mengatur pelari yang dikelola sendiri. 1. Lanjutkan dengan nilai default dan kemudian pilih **Create build project**. 1. Buka GitLab konsol di `https://gitlab.com/user-name/repository-name/-/hooks` untuk memverifikasi bahwa webhook telah dibuat dan diaktifkan untuk mengirimkan peristiwa **pekerjaan Alur Kerja**. ## Langkah 2: Buat file.gitlab-ci.yl di repositori Anda Pada langkah ini, Anda akan membuat `.gitlab-ci.yml` file [https://gitlab.com/](https://gitlab.com/)untuk mengonfigurasi lingkungan build Anda dan menggunakan pelari yang GitLab dikelola sendiri. CodeBuild Untuk informasi selengkapnya, lihat [Menggunakan pelari yang dikelola sendiri](https://docs.gitlab.com/runner/#use-self-managed-runners). ### Perbarui pipa GitLab CI/CD YAMM Anda Arahkan ke `https://gitlab.com/user-name/project-name/-/tree/branch-name` dan buat `.gitlab-ci.yml` file di repositori Anda. Anda dapat mengonfigurasi lingkungan build dengan melakukan salah satu hal berikut: + Anda dapat menentukan nama CodeBuild proyek, dalam hal ini build akan menggunakan konfigurasi proyek yang ada untuk komputasi, gambar, versi gambar, dan ukuran instance. Nama proyek diperlukan untuk menautkan pengaturan AWS terkait GitLab pekerjaan Anda ke CodeBuild proyek tertentu. Dengan memasukkan nama proyek di YAMAL, CodeBuild diizinkan untuk memanggil pekerjaan dengan pengaturan proyek yang benar. ``` tags: - codebuild--$CI_PROJECT_ID-$CI_PIPELINE_IID-$CI_JOB_NAME ``` `$CI_PROJECT_ID-$CI_PIPELINE_IID-$CI_JOB_NAME`diperlukan untuk memetakan build ke pekerjaan pipeline tertentu yang berjalan dan menghentikan pembangunan saat proses pipeline dibatalkan. **catatan** Pastikan bahwa Anda ** cocok dengan nama proyek yang Anda buat CodeBuild. Jika tidak cocok, tidak CodeBuild akan memproses webhook dan pipeline GitLab CI/CD mungkin hang. Berikut ini adalah contoh dari pipa GitLab CI/CD YAMB: ``` workflow: name: HelloWorld stages: # List of stages for jobs, and their order of execution - build build-job: # This job runs in the build stage, which runs first. stage: build script: - echo "Hello World!" tags: - codebuild-myProject-$CI_PROJECT_ID-$CI_PIPELINE_IID-$CI_JOB_NAME ``` + Anda juga dapat mengganti gambar dan jenis komputasi di tag. Lihat [Hitung gambar yang didukung dengan pelari yang CodeBuild di-host GitLab](sample-gitlab-runners-gitlab-ci.images.md) untuk daftar gambar yang dikuratori. Untuk menggunakan gambar kustom, lihat[Penggantian label didukung dengan pelari yang CodeBuild di-host GitLab](gitlab-runners-update-labels.md). Jenis komputasi dan gambar dalam tag akan mengganti pengaturan lingkungan pada proyek Anda. Untuk mengganti setelan lingkungan Anda untuk build komputasi Amazon EC2, gunakan sintaks berikut: ``` tags: - codebuild--$CI_PROJECT_ID-$CI_PIPELINE_IID-$CI_JOB_NAME - image:- - instance-size: ``` Berikut ini adalah contoh dari pipa GitLab CI/CD YAMB: ``` stages: - build build-job: stage: build script: - echo "Hello World!" tags: - codebuild-myProject-$CI_PROJECT_ID-$CI_PIPELINE_IID-$CI_JOB_NAME - image:arm-3.0 - instance-size:small ``` + Anda dapat mengganti armada yang digunakan untuk build Anda di tag. Ini akan menggantikan pengaturan armada yang dikonfigurasi pada proyek Anda untuk menggunakan armada yang ditentukan. Untuk informasi selengkapnya, lihat [Jalankan build di atas armada kapasitas cadangan](fleets.md). Untuk mengganti setelan armada untuk build komputasi Amazon EC2, gunakan sintaks berikut: ``` tags: - codebuild--$CI_PROJECT_ID-$CI_PIPELINE_IID-$CI_JOB_NAME - fleet: ``` Untuk mengganti armada dan gambar yang digunakan untuk build, gunakan sintaks berikut: ``` tags: - codebuild--$CI_PROJECT_ID-$CI_PIPELINE_IID-$CI_JOB_NAME - fleet: - image:- ``` Berikut ini adalah contoh dari pipa GitLab CI/CD YAMB: ``` stages: - build build-job: stage: build script: - echo "Hello World!" tags: - codebuild-myProject-$CI_PROJECT_ID-$CI_PIPELINE_IID-$CI_JOB_NAME - fleet:myFleet - image:arm-3.0 ``` + Untuk menjalankan tugas pipeline GitLab CI/CD Anda pada gambar kustom, Anda dapat mengonfigurasi gambar kustom dalam CodeBuild proyek Anda dan menghindari memberikan label penggantian gambar. CodeBuild akan menggunakan gambar yang dikonfigurasi dalam proyek jika tidak ada label penggantian gambar yang disediakan. Setelah Anda melakukan perubahan`.gitlab-ci.yml`, GitLab pipeline akan dipicu dan `build-job` akan mengirim notifikasi webhook yang akan memulai build in CodeBuild Anda. ### Jalankan perintah buildspec fase INSTALL, PRE\$1BUILD, dan POST\$1BUILD Secara default, CodeBuild abaikan perintah buildspec apa pun saat menjalankan build yang dikelola sendiri. GitLab Untuk menjalankan perintah buildspec selama build, `buildspec-override:true` dapat ditambahkan sebagai akhiran untuk: `tags` ``` tags: - codebuild--$CI_PROJECT_ID-$CI_PIPELINE_IID-$CI_JOB_NAME - buildspec-override:true ``` Dengan menggunakan perintah ini, CodeBuild akan membuat folder yang disebut `gitlab-runner` dalam folder sumber utama wadah. Ketika GitLab pelari dimulai selama `BUILD` fase, pelari akan berjalan di direktori. `gitlab-runner` Ada beberapa batasan saat menggunakan penggantian buildspec dalam build yang dikelola sendiri: GitLab + CodeBuild tidak akan menjalankan perintah buildspec selama `BUILD` fase, karena pelari yang dikelola sendiri berjalan dalam fase tersebut. `BUILD` + CodeBuild tidak akan mengunduh sumber primer atau sekunder apa pun selama `DOWNLOAD_SOURCE` fase berlangsung. Jika Anda memiliki file buildspec yang dikonfigurasi, hanya file itu yang akan diunduh dari sumber utama proyek. + Jika perintah build gagal di `INSTALL` fase `PRE_BUILD` atau, tidak CodeBuild akan memulai runner yang dikelola sendiri dan pekerjaan pipeline GitLab CI/CD perlu dibatalkan secara manual. + CodeBuild mengambil token runner selama `DOWNLOAD_SOURCE` fase, yang memiliki waktu kedaluwarsa satu jam. Jika `INSTALL` fase `PRE_BUILD` atau fase Anda melebihi satu jam, token runner mungkin kedaluwarsa sebelum pelari yang GitLab dikelola sendiri dimulai. ## Langkah 3: Tinjau hasil Anda Setiap kali pekerjaan GitLab CI/CD pipeline run occurs, CodeBuild would receive the CI/CD pipeline job events through the webhook. For each job in the CI/CD pipeline, CodeBuild starts a build to run an ephemeral GitLab runner. The runner is responsible for executing a single CI/CD pipa. Setelah pekerjaan selesai, runner dan proses build terkait akan segera dihentikan. Untuk melihat log pekerjaan CI/CD pipeline, navigasikan ke repositori GitLab, pilih **Build**, **Jobs**, lalu pilih **Job spesifik** yang ingin Anda tinjau log. Anda dapat meninjau label yang diminta di log saat pekerjaan menunggu untuk diambil oleh pelari yang dikelola sendiri. CodeBuild ## Filter acara GitLab webhook ()CloudFormation Bagian CloudFormation template yang diformat YAML berikut akan membuat grup filter yang memicu build saat dievaluasi ke true. Grup filter berikut menentukan nama GitLab CI/CD pipeline job request with a CI/CD pipeline yang cocok dengan ekspresi `\[CI-CodeBuild\]` reguler. ``` CodeBuildProject: Type: AWS::CodeBuild::Project Properties: Name: MyProject ServiceRole: service-role Artifacts: Type: NO_ARTIFACTS Environment: Type: LINUX_CONTAINER ComputeType: BUILD_GENERAL1_SMALL Image: aws/codebuild/standard:5.0 Source: Type: GITLAB Location: CODEBUILD_DEFAULT_WEBHOOK_SOURCE_LOCATION Triggers: Webhook: true ScopeConfiguration: Name: group-name Scope: GITLAB_GROUP FilterGroups: - - Type: EVENT Pattern: WORKFLOW_JOB_QUEUED - Type: WORKFLOW_NAME Pattern: \[CI-CodeBuild\] ``` # Penggantian label didukung dengan pelari yang CodeBuild di-host GitLab Di YAMAL pipeline GitLab CI/CD, Anda dapat memberikan berbagai penggantian label yang memodifikasi build runner yang dikelola sendiri. Setiap build yang tidak dikenali oleh CodeBuild akan diabaikan tetapi tidak akan gagal permintaan webhook Anda. Misalnya, YAMAL berikut menyertakan penggantian untuk image, ukuran instans, armada, dan spesifikasi build: ``` workflow: name: HelloWorld stages: - build build-job: stage: build script: - echo "Hello World!" tags: - codebuild-myProject-$CI_PROJECT_ID-$CI_PIPELINE_IID-$CI_JOB_NAME - image:arm-3.0 - instance-size:small - fleet:myFleet - buildspec-override:true ``` `codebuild--$CI_PROJECT_ID-$CI_PIPELINE_IID-$CI_JOB_NAME`(diperlukan) + Contoh: `codebuild-myProject-$CI_PROJECT_ID-$CI_PIPELINE_IID-$CI_JOB_NAME` + Diperlukan untuk semua pipa GitLab CI/CD. YAMLs **harus sama dengan nama proyek tempat webhook pelari yang dikelola sendiri dikonfigurasi. `image:-` + Contoh: `image:arm-3.0` + Mengganti jenis gambar dan lingkungan yang digunakan saat memulai build runner yang dikelola sendiri. Untuk mempelajari nilai yang didukung, lihat[Hitung gambar yang didukung dengan pelari yang CodeBuild di-host GitLab](sample-gitlab-runners-gitlab-ci.images.md). + Untuk mengganti jenis gambar dan lingkungan yang digunakan dengan gambar kustom, gunakan `image:custom--` + Contoh: `image:custom-arm-public.ecr.aws/codebuild/amazonlinux-aarch64-standard:3.0` **catatan** Jika gambar kustom berada di registri pribadi, lihat[Konfigurasikan kredenal registri pribadi untuk pelari yang dihosting sendiri](private-registry-sample-configure-runners.md). `instance-size:` + Contoh: `instance-size:small` + Mengganti tipe instance yang digunakan saat memulai build runner yang dikelola sendiri. Untuk mempelajari nilai yang didukung, lihat[Hitung gambar yang didukung dengan pelari yang CodeBuild di-host GitLab](sample-gitlab-runners-gitlab-ci.images.md). `fleet:` + Contoh: `fleet:myFleet` + Mengganti pengaturan armada yang dikonfigurasi pada proyek Anda untuk menggunakan armada yang ditentukan. Untuk informasi selengkapnya, lihat [Jalankan build di atas armada kapasitas cadangan](fleets.md). `buildspec-override:` + Contoh: `buildspec-override:true` + Mengizinkan build menjalankan perintah buildspec di`INSTALL`,`PRE_BUILD`, dan `POST_BUILD` fase jika disetel ke. `true` # Hitung gambar yang didukung dengan pelari yang CodeBuild di-host GitLab Pada label yang Anda konfigurasikan[Tutorial: Konfigurasikan pelari yang CodeBuild di-host GitLab](sample-gitlab-runners.md), Anda dapat mengganti pengaturan lingkungan Amazon EC2 dengan menggunakan nilai di tiga kolom pertama. CodeBuild menyediakan gambar komputasi Amazon EC2 berikut. Untuk informasi lebih lanjut tentang [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/codebuild/latest/userguide/sample-gitlab-runners-gitlab-ci.images.html) Selain itu, Anda dapat mengganti pengaturan lingkungan Lambda Anda dengan menggunakan nilai berikut. Untuk informasi selengkapnya tentang komputasi CodeBuild Lambda, lihat. [Jalankan build pada komputasi AWS Lambda](lambda.md) CodeBuild mendukung gambar komputasi Lambda berikut: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/codebuild/latest/userguide/sample-gitlab-runners-gitlab-ci.images.html) Untuk informasi selengkapnya, lihat [Bangun mode dan tipe komputasi lingkungan](build-env-ref-compute-types.md) dan [Gambar Docker disediakan oleh CodeBuild](build-env-ref-available.md).