Membuat layanan

Untuk menyebarkan aplikasi denganAWS Proton, sebagai pengembang, Anda membuat layanan dan memberikan masukan berikut.

1. Nama templateAWS Proton layanan yang diterbitkan oleh tim platform.

2. Nama untuk layanan ini.

3. Jumlah instans layanan yang ingin Anda gunakan.

4. Pilihan lingkungan yang ingin Anda gunakan.

5. Koneksi ke repositori kode Anda jika Anda menggunakan template layanan yang menyertakan pipeline layanan (opsional).

Apa yang ada di layanan?

Saat membuatAWS Proton layanan, Anda dapat memilih dari dua jenis templat layanan:

• Template layanan yang menyertakan pipeline layanan (default).

• Template layanan yang tidak menyertakan pipeline layanan.

Anda harus membuat setidaknya satu instans layanan saat membuat layanan.

Instance layanan dan pipeline opsional dikaitkan dengan layanan. Anda hanya dapat membuat atau menghapus pipeline dalam konteks layanan membuat dan menghapus tindakan. Untuk mempelajari cara menambah dan menghapus instans dari layanan, lihatMengedit layanan.

catatan

Lingkungan Anda dikonfigurasi untuk penyediaan yang dikelola sendiri atau dikelola sendiri.AWS AWS Protonketentuan layanan dalam lingkungan menggunakan metode penyediaan yang sama seperti lingkungan menggunakan. Pengembang yang membuat atau memperbarui instance layanan tidak melihat perbedaan dan pengalaman mereka sama dalam kedua kasus tersebut.

Untuk informasi lebih lanjut tentang metode penyediaan, lihatBagaimana AWS Proton ketentuan infrastruktur.

Templat layanan

Baik versi utama dan minor dari template layanan yang tersedia. Ketika Anda menggunakan konsol, Anda memilih versiRecommended utama dan minor terbaru dari template layanan. Bila Anda menggunakanAWS CLI dan Anda hanya menentukan versi utama dari template layanan, Anda secara implisit menentukan versiRecommended minor terbarunya.

Berikut ini menjelaskan perbedaan antara versi template mayor dan minor dan penggunaannya.

• Versi baru template menjadiRecommended segera setelah disetujui oleh anggota tim platform. Ini berarti bahwa layanan baru dibuat menggunakan versi itu, dan Anda diminta untuk memperbarui layanan yang ada ke versi baru.

• MelaluiAWS Proton, tim platform dapat secara otomatis memperbarui instance layanan ke versi minor baru dari template layanan. Versi minor harus kompatibel ke belakang.

• Karena versi utama mengharuskan Anda untuk memberikan input baru sebagai bagian dari proses pembaruan, Anda perlu memperbarui layanan Anda ke versi utama template layanannya. Versi mayor tidak kompatibel ke belakang.

Membuat layanan

Prosedur berikut menunjukkan cara menggunakanAWS Proton konsol atauAWS CLI membuat layanan dengan atau tanpa layanan.

AWS Management Console

Membuat layanan seperti yang ditunjukkan dalam langkah-langkah konsol berikut ini.

1. Di AWS Protonkonsol, pilih Layanan.

2. Pilih Buat layanan.

3. Di halaman Pilih template layanan, pilih templat dan pilih Konfigurasi.

   Bila Anda tidak ingin menggunakan pipeline yang diaktifkan, pilih template yang ditandai dengan pipeline Tidak termasuk untuk layanan Anda.

4. Di halaman Konfigurasi layanan, di bagian Pengaturan layanan, masukkan nama Layanan.

5. (Opsional) Masukkan deskripsi untuk layanan ini.

6. Di bagian Pengaturan repositori layanan:

   1. Untuk CodeStar Koneksi, pilih koneksi Anda dari daftar.

   2. Untuk ID Repositori, pilih nama repositori kode sumber Anda dari daftar.

   3. Untuk nama cabang, pilih nama cabang repositori kode sumber Anda dari daftar.

7. (Opsional) Di bagian Tag, pilih Tambahkan tag baru dan masukkan kunci dan nilai untuk membuat tag yang dikelola pelanggan.

8. Pilih Selanjutnya.

9. Di halaman Konfigurasikan pengaturan khusus, di bagian Instans layanan, di bagian Instans baru. Anda harus memasukkan nilai untukrequired parameter. Anda dapat memasukkan nilai untukoptional parameter atau menggunakan default saat diberikan.

10. Di bagian input Pipeline, Anda harus memasukkan nilai untukrequired parameter. Anda dapat memasukkan nilai untukoptional parameter atau menggunakan default saat diberikan.

11. Pilih Berikutnya dan tinjau masukan Anda.

12. Pilih Create (Buat).

    Lihat detail dan status layanan, serta tagAWS terkelola dan tag yang dikelola pelanggan untuk layanan Anda.

13. Di panel navigasi, pilih Layanan.

    Halaman baru menampilkan daftar layanan Anda bersama dengan status dan detail layanan lainnya.

AWS CLI

Saat Anda menggunakanAWS CLI, Anda menentukan input layanan dalamspec file berformat YAKL.aws-proton/service.yaml, yang terletak di direktori kode sumber Anda.

Anda dapat menggunakanget-service-template-minor-version perintah CLI untuk melihat skema yang diperlukan dan parameter opsional yang Anda berikan nilai dalam file spesifikasi Anda.

Jika Anda ingin menggunakan template layanan yang dimilikipipelineProvisioning: "CUSTOMER_MANAGED", jangan sertakanpipeline: bagian dalam spesifikasi Anda dan jangan sertakan-repository-connection-arn,-repository-id, dan-branch-name parameter dalamcreate-service perintah Anda.

Buat layanan dengan pipeline layanan seperti yang ditunjukkan pada langkah-langkah CLI berikut.

1. Siapkan peran layanan untuk pipeline seperti yang ditunjukkan pada perintah contoh CLI berikut.

   Perintah:

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

2. Daftar berikut menunjukkan contoh spesifikasi, berdasarkan skema template layanan, yang mencakup pipeline layanan dan input instance.

   Spek:

   proton: ServiceSpec
   
   pipeline:
     my_sample_pipeline_required_input: "hello"
     my_sample_pipeline_optional_input: "bye"
   
   instances:
     - name: "acme-network-dev"
       environment: "ENV_NAME"
       spec:
         my_sample_service_instance_required_input: "hi"
         my_sample_service_instance_optional_input: "ho"
   

   Buat layanan dengan pipeline seperti yang ditunjukkan dalam contoh perintah CLI berikut dan respon.

   Perintah:

   $ aws proton create-service \
           --name "MySimpleService" \
           --branch-name "mainline" \
           --template-major-version "1" \
           --template-name "fargate-service" \
           --repository-connection-arn "arn:aws:codestar-connections:region-id:123456789012:connection/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" \
           --repository-id "myorg/myapp" \
           --spec "file://spec.yaml"

   Jawaban:

   {
       "service": {
           "arn": "arn:aws:proton:region-id:123456789012:service/MySimpleService",
           "createdAt": "2020-11-18T19:50:27.460000+00:00",
           "lastModifiedAt": "2020-11-18T19:50:27.460000+00:00",
           "name": "MySimpleService",
           "repositoryConnectionArn": "arn:aws:codestar-connections:region-id:123456789012:connection/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
           "repositoryId": "myorg/myapp",
           "status": "CREATE_IN_PROGRESS",
           "templateName": "fargate-service"
       }
   }

Buat layanan tanpa pipeline layanan seperti yang ditunjukkan dalam contoh perintah CLI berikut dan respon.

Berikut ini menunjukkan contoh spesifikasi yang tidak menyertakan input pipeline layanan.

Spek:

proton: ServiceSpec

instances:
  - name: "acme-network-dev"
    environment: "ENV_NAME"
    spec:
      my_sample_service_instance_required_input: "hi"
      my_sample_service_instance_optional_input: "ho"

Untuk membuat layanan tanpa pipeline layanan yang disediakan, Anda menyediakan jalur kespec.yaml dan Anda tidak menyertakan parameter repositori seperti yang ditunjukkan pada perintah dan respons contoh CLI berikut.

Perintah:

$ aws proton create-service \
        --name "MySimpleServiceNoPipeline" \
        --template-major-version "1" \
        --template-name "fargate-service" \
        --spec "file://spec-no-pipeline.yaml"

Jawaban:

{
    "service": {
        "arn": "arn:aws:proton:region-id:123456789012:service/MySimpleServiceNoPipeline",
        "createdAt": "2020-11-18T19:50:27.460000+00:00",
        "lastModifiedAt": "2020-11-18T19:50:27.460000+00:00",
        "name": "MySimpleServiceNoPipeline",
        "status": "CREATE_IN_PROGRESS",
        "templateName": "fargate-service-no-pipeline"
    }
}