

Pemberitahuan akhir dukungan: Pada 7 Oktober 2026, AWS akan mengakhiri dukungan untuk AWS Proton. Setelah 7 Oktober 2026, Anda tidak akan lagi dapat mengakses AWS Proton konsol atau AWS Proton sumber daya. Infrastruktur yang Anda gunakan akan tetap utuh. Untuk informasi selengkapnya, lihat Panduan [AWS Proton Pengakhiran Layanan dan Migrasi](https://docs.aws.amazon.com/proton/latest/userguide/proton-end-of-support.html).

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

# Bagaimana cara AWS Proton kerja
<a name="ag-works"></a>

Dengan AWS Proton, Anda menyediakan *lingkungan*, dan kemudian *layanan* yang berjalan di lingkungan tersebut. Lingkungan dan layanan didasarkan pada *template* lingkungan dan layanan, masing-masing, yang Anda pilih di pustaka templat AWS Proton berversi Anda.

![\[Diagram yang menjelaskan proses bagaimana membuat bundel template untuk satu set sumber daya AWS Proton infrastruktur.\]](http://docs.aws.amazon.com/id_id/proton/latest/userguide/images/works.png)


 ![\[Red circle with the number 1 inside, typically used as a notification icon.\]](http://docs.aws.amazon.com/id_id/proton/latest/userguide/images/label-one.png)Ketika Anda, sebagai administrator, memilih template lingkungan dengan AWS Proton, Anda memberikan nilai untuk *parameter input* yang diperlukan.

 ![\[Number 2 icon in a pink circle.\]](http://docs.aws.amazon.com/id_id/proton/latest/userguide/images/label-two.png) AWS Proton menggunakan template lingkungan dan nilai parameter untuk menyediakan lingkungan Anda.

 ![\[Pink square icon with a white exclamation mark inside a circle.\]](http://docs.aws.amazon.com/id_id/proton/latest/userguide/images/label-three.png)Ketika Anda, sebagai pengembang atau administrator, memilih template layanan dengan AWS Proton, Anda memberikan nilai untuk parameter input yang diperlukan. Anda juga memilih lingkungan untuk menyebarkan aplikasi atau layanan Anda.

 ![\[Number 4 in a red circle icon, commonly used to indicate a notification count.\]](http://docs.aws.amazon.com/id_id/proton/latest/userguide/images/label-four.png) AWS Proton menggunakan templat layanan, dan nilai parameter layanan dan lingkungan yang dipilih, untuk menyediakan layanan Anda.

Anda memberikan nilai untuk parameter input untuk menyesuaikan template Anda untuk digunakan kembali dan beberapa kasus penggunaan, aplikasi, atau layanan.

Untuk membuat ini berfungsi, Anda membuat bundel template lingkungan atau layanan dan mengunggahnya ke lingkungan terdaftar atau templat layanan, masing-masing.

[Bundel template](ag-template-authoring.md#ag-template-bundles) berisi semua yang AWS Proton dibutuhkan untuk menyediakan lingkungan atau layanan.

Saat membuat template lingkungan atau layanan, Anda mengunggah bundel templat yang berisi file parametrized infrastructure as code (IAc) yang AWS Proton digunakan untuk menyediakan lingkungan atau layanan.

Saat Anda memilih template lingkungan atau layanan untuk membuat atau memperbarui lingkungan atau layanan, Anda memberikan nilai untuk parameter file iAc bundel template.

**Topics**
+ [AWS Proton benda-benda](ag-works-objects.md)
+ [Bagaimana AWS Proton ketentuan infrastruktur](ag-works-prov-methods.md)
+ [AWS Proton terminologi](terminology.md)

# AWS Proton benda-benda
<a name="ag-works-objects"></a>

Diagram berikut menunjukkan AWS Proton objek utama dan hubungannya dengan objek lain AWS dan pihak ketiga. Panah mewakili arah aliran data (arah ketergantungan terbalik).

Kami mengikuti diagram dengan deskripsi singkat dan tautan referensi untuk AWS Proton objek-objek ini.

![\[Diagram yang menggambarkan AWS-managed provisioning di AWS Proton\]](http://docs.aws.amazon.com/id_id/proton/latest/userguide/images/object-diagram.png)

+ **Template lingkungan** - Kumpulan versi template lingkungan yang dapat digunakan untuk membuat AWS Proton lingkungan.

  Untuk informasi selengkapnya, lihat [Penulisan templat dan bundel](ag-template-authoring.md) dan [AWS Proton template](ag-templates.md).
+ **Versi template lingkungan** - Versi spesifik dari template lingkungan. Mengambil *bundel template* sebagai input, baik dari bucket S3 atau dari repositori Git. Bundel menentukan Infrastructure as Code (IAc) dan parameter input terkait untuk suatu AWS Proton lingkungan.

  Lihat informasi selengkapnya di [Template berversi](ag-template-versions.md), [Daftarkan dan terbitkan templat](template-create.md), dan [Konfigurasi sinkronisasi templat](ag-template-sync-configs.md).
+ **Lingkungan** - Kumpulan sumber daya AWS infrastruktur bersama dan kebijakan akses yang digunakan AWS Proton layanan. AWS sumber daya disediakan dengan menggunakan versi template lingkungan yang dipanggil dengan nilai parameter tertentu. Kebijakan akses disediakan dalam peran layanan.

  Untuk informasi selengkapnya, lihat [AWS Proton lingkungan](ag-environments.md).
+ **Template layanan** — Kumpulan versi template layanan yang dapat digunakan untuk membuat AWS Proton layanan.

  Untuk informasi selengkapnya, lihat [Penulisan templat dan bundel](ag-template-authoring.md) dan [AWS Proton template](ag-templates.md).
+ **Versi template layanan** - Versi spesifik dari template layanan. Mengambil *bundel template* sebagai input, baik dari bucket S3 atau dari repositori Git. Bundel menentukan Infrastructure as Code (IAc) dan parameter input terkait untuk suatu AWS Proton layanan.

  Versi template layanan juga menentukan batasan ini pada instance layanan berdasarkan versi:
  + **Template lingkungan yang kompatibel** - Instans hanya dapat berjalan di lingkungan berdasarkan templat lingkungan yang kompatibel ini.
  + **Sumber komponen yang didukung** — Jenis komponen yang dapat diasosiasikan pengembang dengan instance.

  Lihat informasi selengkapnya di [Template berversi](ag-template-versions.md), [Daftarkan dan terbitkan templat](template-create.md), dan [Konfigurasi sinkronisasi templat](ag-template-sync-configs.md).
+ **Service** - Kumpulan instance layanan yang menjalankan aplikasi menggunakan sumber daya yang ditentukan dalam template layanan, dan opsional CI/CD pipeline yang menyebarkan kode aplikasi ke instance ini.

  Dalam diagram, garis putus-putus dari **template Layanan** berarti bahwa layanan meneruskan template ke instance layanan dan pipeline.

  Untuk informasi selengkapnya, lihat [AWS Proton layanan](ag-services.md).
+ **Service instance** — Kumpulan sumber daya AWS infrastruktur yang menjalankan aplikasi di AWS Proton lingkungan tertentu. AWS sumber daya disediakan dengan menggunakan versi templat layanan yang dipanggil dengan nilai parameter tertentu.

  Untuk informasi selengkapnya, lihat [AWS Proton layanan](ag-services.md) dan [Memperbarui instance layanan](ag-svc-instance-update.md).
+ **Pipeline** — CI/CD Pipeline opsional yang menyebarkan aplikasi ke dalam instance layanan, dengan kebijakan akses untuk menyediakan pipeline ini. Kebijakan akses disediakan dalam peran layanan. Layanan tidak selalu memiliki AWS Proton pipeline terkait—Anda dapat memilih untuk mengelola penerapan kode aplikasi di luar. AWS Proton

  Dalam diagram, garis putus-putus dari **Layanan** dan kotak putus-putus di sekitar **Pipeline** berarti bahwa jika Anda memilih untuk mengelola CI/CD penerapan sendiri, AWS Proton pipeline mungkin tidak dibuat, dan pipeline Anda sendiri mungkin tidak berada dalam akun Anda. AWS 

  Untuk informasi selengkapnya, lihat [AWS Proton layanan](ag-services.md) dan [Memperbarui saluran layanan](ag-svc-pipeline-update.md).
+ **Komponen** - Ekstensi yang ditentukan pengembang untuk instance layanan. Menentukan sumber daya AWS infrastruktur tambahan yang mungkin dibutuhkan aplikasi tertentu, selain sumber daya yang disediakan oleh lingkungan dan instance layanan. Tim platform mengontrol infrastruktur yang dapat disediakan komponen dengan melampirkan peran komponen ke lingkungan.

  Untuk informasi selengkapnya, lihat [AWS Proton komponen](ag-components.md).

# Bagaimana AWS Proton ketentuan infrastruktur
<a name="ag-works-prov-methods"></a>

AWS Proton dapat menyediakan infrastruktur dengan salah satu dari beberapa cara:
+ **AWS-managed provisioning** — AWS Proton memanggil mesin penyediaan atas nama Anda. Metode ini hanya mendukung bundel AWS CloudFormation template. Untuk informasi selengkapnya, lihat [CloudFormation File iAc](ag-infrastructure-tmp-files-cloudformation.md).
+ **CodeBuild provisioning** — AWS Proton digunakan AWS CodeBuild untuk menjalankan perintah shell yang Anda berikan. Perintah Anda dapat membaca input yang AWS Proton menyediakan, dan bertanggung jawab untuk penyediaan atau deprovisioning infrastruktur dan menghasilkan nilai output. Bundel template untuk metode ini menyertakan perintah Anda dalam file manifes dan program, skrip, atau file lain yang mungkin diperlukan oleh perintah ini.

  Sebagai contoh untuk menggunakan CodeBuild penyediaan, Anda dapat menyertakan kode yang menggunakan AWS sumber daya AWS Cloud Development Kit (AWS CDK) untuk menyediakan, dan manifes yang menginstal CDK dan menjalankan kode CDK Anda.

  Untuk informasi selengkapnya, lihat [CodeBuild bundel templat penyediaan](ag-infrastructure-tmp-files-codebuild.md).
**catatan**  
Anda dapat menggunakan CodeBuild penyediaan dengan lingkungan dan layanan. Saat ini Anda tidak dapat menyediakan komponen dengan cara ini.
+ **Penyediaan yang dikelola sendiri — AWS Proton mengeluarkan** permintaan tarik (PR) ke repositori yang Anda sediakan, tempat sistem penyebaran infrastruktur Anda sendiri menjalankan proses penyediaan. Metode ini hanya mendukung bundel template Terraform. Untuk informasi selengkapnya, lihat [File Terraform IAc](ag-infrastructure-tmp-files-terraform.md).

AWS Proton menentukan dan menetapkan metode penyediaan untuk setiap lingkungan dan layanan secara terpisah. Saat Anda membuat atau memperbarui lingkungan atau layanan, AWS Proton periksa bundel templat yang Anda berikan, dan tentukan metode penyediaan yang ditunjukkan oleh bundel templat. Pada tingkat lingkungan, Anda memberikan parameter yang mungkin dibutuhkan lingkungan dan layanan potensial untuk metode penyediaannya—AWS Identity and Access Management (IAM) peran, koneksi akun lingkungan, atau repositori infrastruktur.

Pengembang yang menggunakan AWS Proton untuk menyediakan layanan memiliki pengalaman yang sama terlepas dari metode penyediaan. Pengembang tidak perlu mengetahui metode penyediaan dan tidak perlu mengubah apa pun dalam proses penyediaan layanan. Templat layanan menetapkan metode penyediaan, dan setiap lingkungan yang digunakan pengembang layanan untuk menyediakan parameter yang diperlukan untuk penyediaan instance layanan.

Diagram berikut merangkum beberapa ciri utama dari metode penyediaan yang berbeda. Bagian yang mengikuti tabel memberikan rincian tentang setiap metode.


| Metode penyediaan | Template | Disediakan oleh | Status dilacak oleh | 
| --- | --- | --- | --- | 
| AWS-dikelola | manifes, skema, file IAc () CloudFormation | AWS Proton (melalui CloudFormation) | AWS Proton (melalui CloudFormation) | 
| CodeBuild | manifes (dengan perintah), skema, dependensi perintah (misalnya kode) AWS CDK  | AWS Proton (melalui CodeBuild) | AWS Proton (perintah Anda mengembalikan status melalui CodeBuild) | 
| dikelola sendiri | manifes, skema, file IAc (Terraform) | Kode Anda (melalui tindakan Git) | Kode Anda (diteruskan AWS melalui panggilan API) | 

## Cara kerja AWS-managed provisioning
<a name="ag-works-prov-methods-direct"></a>

Ketika lingkungan atau layanan menggunakan AWS-managed provisioning, infrastruktur disediakan sebagai berikut:

1.  AWS Proton Pelanggan (administrator atau pengembang) menciptakan AWS Proton sumber daya (lingkungan atau layanan). Pelanggan memilih templat untuk sumber daya dan menyediakan parameter yang diperlukan. Untuk informasi lebih lanjut, lihat bagian berikut,[Pertimbangan untuk penyediaan AWS-managed](#ag-works-prov-methods-direct-consider).

1. AWS Proton membuat CloudFormation template lengkap untuk menyediakan sumber daya.

1. AWS Proton panggilan CloudFormation untuk memulai penyediaan menggunakan template yang dirender.

1. AWS Proton terus memantau CloudFormation penyebaran.

1. Saat penyediaan selesai, AWS Proton laporkan kembali kesalahan jika terjadi kegagalan, dan menangkap output penyediaan, seperti ID VPC Amazon, jika berhasil.

Diagram berikut menunjukkan bahwa AWS Proton menangani sebagian besar langkah-langkah ini secara langsung.

![\[Diagram yang menggambarkan AWS-managed provisioning di AWS Proton\]](http://docs.aws.amazon.com/id_id/proton/latest/userguide/images/provisioning-direct.png)


### Pertimbangan untuk penyediaan AWS-managed
<a name="ag-works-prov-methods-direct-consider"></a>
+ *Peran penyediaan infrastruktur* — Ketika lingkungan atau salah satu instance layanan yang berjalan di dalamnya mungkin menggunakan AWS-managed provisioning, administrator perlu mengonfigurasi peran IAM (baik secara langsung atau sebagai bagian dari koneksi akun lingkungan). AWS Proton AWS Proton menggunakan peran ini untuk menyediakan infrastruktur sumber daya penyediaan AWS yang dikelola ini. Peran harus memiliki izin untuk digunakan CloudFormation untuk membuat semua sumber daya yang disertakan dalam templat sumber daya ini.

  Untuk informasi selengkapnya, lihat [Peran IAM](ag-environment-roles.md) dan [AWS Proton Contoh kebijakan peran layanan IAM](security_iam_service-role-policy-examples.md).
+ *Penyediaan layanan* — Saat pengembang menerapkan instance layanan yang menggunakan AWS-managed provisioning ke lingkungan, AWS Proton gunakan peran yang diberikan ke lingkungan tersebut untuk menyediakan infrastruktur untuk instance layanan. Pengembang tidak melihat peran ini dan tidak dapat mengubahnya.
+ *Service with pipeline* — Template layanan yang menggunakan AWS-managed provisioning dapat menyertakan definisi pipeline yang ditulis dalam skema YAMB. CloudFormation AWS Proton juga membuat pipeline dengan menelepon CloudFormation. Peran yang AWS Proton digunakan untuk membuat pipa terpisah dari peran untuk setiap lingkungan individu. Peran ini disediakan secara AWS Proton terpisah, hanya sekali di tingkat AWS akun, dan digunakan untuk menyediakan dan mengelola semua saluran pipa yang AWS dikelola. Peran ini harus memiliki izin untuk membuat saluran pipa dan sumber daya lain yang dibutuhkan saluran pipa Anda.

  Prosedur berikut menunjukkan bagaimana memberikan peran pipa ke AWS Proton.

------
#### [ AWS Proton console ]

**Untuk memberikan peran pipa**

  1. Di [AWS Proton konsol](https://console.aws.amazon.com//proton/), pada panel navigasi, pilih **Pengaturan > Pengaturan akun**, lalu pilih **Konfigurasi**.

  1. Gunakan bagian **Pipeline AWS-managed role** untuk mengonfigurasi peran pipeline baru atau yang sudah ada untuk penyediaan AWS-managed.

------
#### [ AWS Proton API ]

**Untuk memberikan peran pipa**

  1. Gunakan tindakan [UpdateAccountSettings](https://docs.aws.amazon.com/proton/latest/APIReference/API_UpdateAccountSettings.html)API.

  1. Berikan Nama Sumber Daya Amazon (ARN) peran layanan pipeline Anda dalam parameter. `pipelineServiceRoleArn`

------
#### [ AWS CLI ]

  **Untuk memberikan peran pipa**

  Jalankan perintah berikut:

  ```
  $ aws proton update-account-settings \
      --pipeline-service-role-arn \
          "arn:aws:iam::123456789012:role/my-pipeline-role"
  ```

------

## Cara CodeBuild kerja penyediaan
<a name="ag-works-prov-methods-codebuild"></a>

Ketika lingkungan atau layanan menggunakan CodeBuild penyediaan, infrastruktur disediakan sebagai berikut:

1.  AWS Proton Pelanggan (administrator atau pengembang) menciptakan AWS Proton sumber daya (lingkungan atau layanan). Pelanggan memilih templat untuk sumber daya dan menyediakan parameter yang diperlukan. Untuk informasi lebih lanjut, lihat bagian berikut,[Pertimbangan untuk penyediaan CodeBuild](#ag-works-prov-methods-codebuild-consider).

1. AWS Proton merender file input dengan nilai parameter masukan untuk penyediaan sumber daya.

1. AWS Proton panggilan CodeBuild untuk memulai pekerjaan. CodeBuild Pekerjaan menjalankan perintah shell pelanggan yang ditentukan dalam template. Perintah ini menyediakan infrastruktur yang diinginkan, sementara secara opsional membaca nilai input.

1. Saat penyediaan selesai, perintah pelanggan akhir mengembalikan status penyediaan CodeBuild dan memanggil tindakan [NotifyResourceDeploymentStatusChange](https://docs.aws.amazon.com/proton/latest/APIReference/API_NotifyResourceDeploymentStatusChange.html) AWS Proton API untuk memberikan output, seperti ID VPC Amazon, jika ada.
**penting**  
Pastikan bahwa perintah Anda mengembalikan status penyediaan dengan benar CodeBuild dan memberikan output. Jika tidak, tidak AWS Proton dapat melacak status penyediaan dengan benar dan tidak dapat memberikan output yang benar ke instance layanan.

Diagram berikut menggambarkan langkah-langkah yang AWS Proton dilakukan dan langkah-langkah yang dilakukan perintah Anda dalam suatu CodeBuild pekerjaan.

![\[Diagram yang menggambarkan penyediaan CodeBuild berbasis di AWS Proton\]](http://docs.aws.amazon.com/id_id/proton/latest/userguide/images/provisioning-codebuild.png)


### Pertimbangan untuk penyediaan CodeBuild
<a name="ag-works-prov-methods-codebuild-consider"></a>
+ *Peran penyediaan infrastruktur* - Ketika lingkungan atau salah satu instance layanan yang berjalan di dalamnya mungkin menggunakan penyediaan CodeBuild berbasis, administrator perlu mengonfigurasi peran IAM (baik secara langsung atau sebagai bagian dari koneksi akun lingkungan). AWS Proton AWS Proton menggunakan peran ini untuk menyediakan infrastruktur sumber daya CodeBuild penyediaan ini. Peran harus memiliki izin untuk digunakan CodeBuild untuk membuat semua sumber daya yang Anda perintahkan dalam templat penyediaan sumber daya ini.

  Untuk informasi selengkapnya, lihat [Peran IAM](ag-environment-roles.md) dan [AWS Proton Contoh kebijakan peran layanan IAM](security_iam_service-role-policy-examples.md).
+ *Penyediaan layanan* — Saat pengembang menerapkan instance layanan yang menggunakan CodeBuild penyediaan ke lingkungan, AWS Proton gunakan peran yang disediakan ke lingkungan tersebut untuk menyediakan infrastruktur untuk instance layanan. Pengembang tidak melihat peran ini dan tidak dapat mengubahnya.
+ *Service with pipeline* — Template layanan yang menggunakan CodeBuild provisioning dapat menyertakan perintah untuk menyediakan pipeline. AWS Proton juga membuat pipeline dengan menelepon CodeBuild. Peran yang AWS Proton digunakan untuk membuat pipa terpisah dari peran untuk setiap lingkungan individu. Peran ini diberikan secara AWS Proton terpisah, hanya sekali di tingkat AWS akun, dan digunakan untuk menyediakan dan mengelola semua pipeline CodeBuild berbasis. Peran ini harus memiliki izin untuk membuat saluran pipa dan sumber daya lain yang dibutuhkan saluran pipa Anda.

  Prosedur berikut menunjukkan bagaimana memberikan peran pipa ke AWS Proton.

------
#### [ AWS Proton console ]

**Untuk memberikan peran pipa**

  1. Di [AWS Proton konsol](https://console.aws.amazon.com//proton/), pada panel navigasi, pilih **Pengaturan > Pengaturan akun**, lalu pilih **Konfigurasi**.

  1. Gunakan bagian **peran penyediaan pipeline Codebuild untuk mengonfigurasi peran** pipeline baru atau yang sudah ada untuk penyediaan. CodeBuild

------
#### [ AWS Proton API ]

**Untuk memberikan peran pipa**

  1. Gunakan tindakan [UpdateAccountSettings](https://docs.aws.amazon.com/proton/latest/APIReference/API_UpdateAccountSettings.html)API.

  1. Berikan Nama Sumber Daya Amazon (ARN) peran layanan pipeline Anda dalam parameter. `pipelineCodebuildRoleArn`

------
#### [ AWS CLI ]

  **Untuk memberikan peran pipa**

  Jalankan perintah berikut:

  ```
  $ aws proton update-account-settings \
      --pipeline-codebuild-role-arn \
          "arn:aws:iam::123456789012:role/my-pipeline-role"
  ```

------

## Cara kerja penyediaan yang dikelola sendiri
<a name="ag-works-prov-methods-self"></a>

Ketika lingkungan dikonfigurasi untuk menggunakan penyediaan yang dikelola sendiri, infrastruktur disediakan sebagai berikut:

1.  AWS Proton Pelanggan (administrator atau pengembang) menciptakan AWS Proton sumber daya (lingkungan atau layanan). Pelanggan memilih templat untuk sumber daya dan menyediakan parameter yang diperlukan. Untuk lingkungan, pelanggan juga menyediakan repositori infrastruktur terkait. Untuk informasi lebih lanjut, lihat bagian berikut,[Pertimbangan untuk penyediaan yang dikelola sendiri](#ag-works-prov-methods-self-consider).

1. AWS Proton membuat template Terraform lengkap. Ini terdiri dari satu atau lebih file Terraform, berpotensi dalam beberapa folder, dan file `.tfvars` variabel. AWS Proton menulis nilai parameter yang disediakan pada panggilan pembuatan sumber daya ke dalam file variabel ini.

1. AWS Proton mengirimkan PR ke repositori infrastruktur dengan template Terraform yang dirender.

1. Saat pelanggan (administrator atau pengembang) menggabungkan PR, otomatisasi pelanggan memicu mesin penyediaan untuk memulai penyediaan infrastruktur menggunakan templat gabungan.
**catatan**  
Jika pelanggan (administrator atau pengembang) menutup PR, AWS Proton mengenali PR sebagai tertutup dan menandai penerapan sebagai dibatalkan.

1. Saat penyediaan selesai, otomatisasi pelanggan memanggil tindakan [NotifyResourceDeploymentStatusChange](https://docs.aws.amazon.com/proton/latest/APIReference/API_NotifyResourceDeploymentStatusChange.html) AWS Proton API untuk menunjukkan penyelesaian, memberikan status (keberhasilan atau kegagalan), dan memberikan output, seperti ID VPC Amazon, jika ada.
**penting**  
Pastikan kode otomatisasi Anda memanggil kembali AWS Proton dengan status penyediaan dan output. Jika tidak, AWS Proton mungkin menganggap penyediaan sebagai tertunda lebih lama dari yang seharusnya, dan terus tampilkan status **Dalam proses**.

Diagram berikut menggambarkan langkah-langkah yang AWS Proton dilakukan dan langkah-langkah yang dilakukan oleh sistem penyediaan Anda sendiri.

![\[Diagram yang menggambarkan penyediaan yang dikelola sendiri di AWS Proton\]](http://docs.aws.amazon.com/id_id/proton/latest/userguide/images/provisioning-self.png)


### Pertimbangan untuk penyediaan yang dikelola sendiri
<a name="ag-works-prov-methods-self-consider"></a>
+ *Repositori infrastruktur* — Ketika administrator mengonfigurasi lingkungan untuk penyediaan yang dikelola sendiri, mereka perlu menyediakan repositori infrastruktur tertaut. AWS Proton mengirimkan PRs ke repositori ini untuk menyediakan infrastruktur lingkungan dan semua instance layanan yang digunakan untuk itu. Tindakan otomatisasi milik pelanggan di repositori harus mengambil peran IAM dengan izin untuk membuat semua sumber daya yang disertakan dalam templat lingkungan dan layanan Anda, dan identitas yang mencerminkan akun tujuan. AWS Untuk contoh GitHub Tindakan yang mengasumsikan peran, lihat [Mengasumsikan](https://github.com/aws-actions/configure-aws-credentials#assuming-a-role) Peran dalam dokumentasi Tindakan Untuk *Tindakan “Konfigurasi AWS Kredensial”. GitHub *
+ *Izin* - Kode penyediaan Anda harus mengautentikasi dengan akun seperlunya (misalnya, mengautentikasi ke AWS akun) dan memberikan otorisasi penyediaan sumber daya (misalnya, memberikan peran).
+ *Penyediaan layanan* — Saat pengembang menerapkan instance layanan yang menggunakan penyediaan yang dikelola sendiri ke lingkungan, AWS Proton mengirimkan PR ke repositori yang terkait dengan lingkungan untuk menyediakan infrastruktur untuk instance layanan. Pengembang tidak melihat repositori dan tidak dapat mengubahnya.
**catatan**  
Pengembang yang membuat layanan menggunakan proses yang sama terlepas dari metode penyediaan, dan perbedaannya diabstraksikan dari mereka. Namun, dengan penyediaan yang dikelola sendiri, pengembang mungkin mengalami respons yang lebih lambat, karena mereka perlu menunggu sampai seseorang (yang mungkin bukan diri mereka sendiri) menggabungkan PR dalam repositori infrastruktur sebelum penyediaan dapat dimulai.
+ *Layanan dengan pipa* — Templat layanan untuk lingkungan dengan penyediaan yang dikelola sendiri dapat mencakup definisi pipa (misalnya, AWS CodePipeline pipa), yang ditulis dalam Terraform HCL. AWS Proton Untuk mengaktifkan penyediaan pipeline ini, administrator menyediakan repositori pipeline tertaut ke. AWS Proton Saat menyediakan pipeline, tindakan otomatisasi milik pelanggan di repositori harus mengambil peran IAM dengan izin untuk menyediakan pipeline, dan identitas yang mencerminkan akun tujuan. AWS Repositori dan peran pipa terpisah dari yang digunakan untuk setiap lingkungan individu. Repositori tertaut disediakan secara AWS Proton terpisah, hanya sekali di tingkat AWS akun, dan digunakan untuk menyediakan dan mengelola semua pipeline. Peran tersebut harus memiliki izin untuk membuat saluran pipa dan sumber daya lain yang dibutuhkan saluran pipa Anda.

  Prosedur berikut menunjukkan bagaimana menyediakan repositori dan peran pipa. AWS Proton

------
#### [ AWS Proton console ]

**Untuk memberikan peran pipa**

  1. Di [AWS Proton konsol](https://console.aws.amazon.com//proton/), pada panel navigasi, pilih **Pengaturan > Pengaturan akun**, lalu pilih **Konfigurasi**.

  1. Gunakan bagian repositori **pipa CI/CD untuk mengonfigurasi tautan repositori** baru atau yang sudah ada.

------
#### [ AWS Proton API ]

**Untuk memberikan peran pipa**

  1. Gunakan tindakan [UpdateAccountSettings](https://docs.aws.amazon.com/proton/latest/APIReference/API_UpdateAccountSettings.html)API.

  1. Berikan penyedia, nama, dan cabang repositori pipeline Anda dalam parameter. `pipelineProvisioningRepository`

------
#### [ AWS CLI ]

  **Untuk memberikan peran pipa**

  Jalankan perintah berikut:

  ```
  $ aws proton update-account-settings \
      --pipeline-provisioning-repository \
          "provider=GITHUB,name=my-pipeline-repo-name,branch=my-branch"
  ```

------
+ *Penghapusan sumber daya yang disediakan sendiri* — Modul Terraform dapat mencakup elemen konfigurasi yang diperlukan untuk operasi Terraform, selain definisi sumber daya. Oleh karena itu, tidak AWS Proton dapat menghapus semua file Terraform untuk lingkungan atau instance layanan. Sebagai gantinya, AWS Proton tandai file untuk dihapus dan perbarui bendera di metadata PR. Otomatisasi Anda dapat membaca flag itu dan menggunakannya untuk memicu perintah terraform destroy.

# AWS Proton terminologi
<a name="terminology"></a>

**Template lingkungan**  
Mendefinisikan infrastruktur bersama, seperti VPC atau cluster, yang digunakan oleh beberapa aplikasi atau sumber daya.

**Bundel template lingkungan**  
Kumpulan file yang Anda unggah untuk membuat dan mendaftarkan template lingkungan AWS Proton. Bundel template lingkungan berisi berikut ini:  

1. File skema yang mendefinisikan infrastruktur sebagai parameter input kode.

1. File infrastruktur sebagai kode (IAc) yang mendefinisikan infrastruktur bersama, seperti VPC atau cluster, yang digunakan oleh beberapa aplikasi atau sumber daya.

1. File manifes yang mencantumkan file IAc.

**Lingkungan**  
Infrastruktur bersama yang disediakan, seperti VPC atau cluster, yang digunakan oleh beberapa aplikasi atau sumber daya.

**Template layanan**  
Mendefinisikan jenis infrastruktur yang diperlukan untuk menyebarkan dan memelihara aplikasi atau layanan mikro di lingkungan.

**Paket template layanan**  
Kumpulan file yang Anda unggah untuk membuat dan mendaftarkan template layanan AWS Proton. Sebuah paket template layanan berisi berikut ini:  

1. File skema yang mendefinisikan infrastruktur sebagai parameter input kode (IAc).

1. File IAC yang mendefinisikan infrastruktur yang diperlukan untuk menyebarkan dan memelihara aplikasi atau layanan mikro di lingkungan.

1. File manifes yang mencantumkan file IAc.

1. Opsional

   1. File IAC yang mendefinisikan infrastruktur pipa layanan.

   1. File manifes yang mencantumkan file IAc.

**Layanan**  
Infrastruktur yang disediakan yang diperlukan untuk menyebarkan dan memelihara aplikasi atau layanan mikro di lingkungan.

**Contoh layanan**  
Infrastruktur yang disediakan yang mendukung aplikasi atau layanan mikro di suatu lingkungan.

**Pipa layanan**  
Infrastruktur yang disediakan yang mendukung pipa.

**Versi template**  
Sebuah versi mayor atau minor dari template. Untuk informasi selengkapnya, lihat [Template berversi](ag-template-versions.md).

**Parameter input**  
Didefinisikan dalam file skema dan digunakan dalam file infrastruktur sebagai kode (IAc) sehingga file IAc dapat digunakan secara berulang dan untuk berbagai kasus penggunaan.

**Berkas skema**  
Mendefinisikan infrastruktur sebagai parameter input file kode.

**Berkas spesifikasi**  
Menentukan nilai untuk infrastruktur sebagai parameter input file kode, seperti yang didefinisikan dalam file skema.

**Berkas manifes**  
Daftar infrastruktur sebagai file kode.