Mengonfigurasi container

Pelajari cara mengonfigurasi port penampung dan perintah serta argumen entrypoint penampung.

Saat layanan Knative memulai container, layanan ini akan menjalankan perintah entrypoint default image dan argumen perintah default. Jika Anda ingin mengganti entrypoint dan argumen perintah default image, Anda dapat menggunakan kolom command dan args dalam konfigurasi container. Kolom command menentukan perintah sebenarnya yang dijalankan oleh container. Kolom args menentukan argumen yang diteruskan ke perintah tersebut.

Mengonfigurasi port penampung

Setiap perubahan konfigurasi akan menghasilkan revisi baru. Revisi selanjutnya juga akan otomatis mendapatkan setelan konfigurasi ini, kecuali jika Anda melakukan pembaruan eksplisit untuk mengubahnya.

Container harus memproses port yang ditentukan oleh variabel lingkungan PORT, bukan port hardcode tertentu. Namun, jika tidak memungkinkan, Anda dapat mengonfigurasi permintaan port mana yang dikirim ke container:

Konsol

  1. Buka Knative serving di konsol Google Cloud :

    Buka Inferensi Knative

  2. Klik Buat Layanan jika Anda mengonfigurasi layanan baru yang akan di-deploy. Jika Anda mengonfigurasi layanan yang sudah ada, klik layanan tersebut, lalu klik Edit & Deploy Revisi Baru.

  3. Di bagian Setelan lanjutan, klik Penampung.

  4. Tentukan port tujuan pengiriman permintaan yang Anda inginkan, jika bukan nilai default 8080. Tindakan ini juga menetapkan variabel lingkungan PORT.

  5. Klik Berikutnya untuk melanjutkan ke bagian berikutnya.

  6. Di bagian Konfigurasi cara layanan ini dipicu, pilih konektivitas yang ingin Anda gunakan untuk memanggil layanan.

  7. Klik Create untuk men-deploy image ke layanan Knative dan tunggu hingga deployment selesai.

Command line

  • Untuk layanan yang sudah ada, perbarui setelan port dengan menjalankan perintah gcloud run services update dengan parameter berikut:

    gcloud run services update SERVICE --port PORT

    Ganti:

    • SERVICE dengan nama layanan.
    • PORT dengan port untuk mengirim permintaan. Perhatikan bahwa port defaultnya adalah 8080.

  • Untuk layanan baru, tetapkan port dengan menjalankan perintah gcloud run deploy dengan parameter --port:

    gcloud run deploy SERVICE --image=IMAGE_URL --port PORT

    Ganti:

    • SERVICE dengan nama layanan.
    • IMAGE_URL dengan referensi ke image container, misalnya, gcr.io/cloudrun/hello.
    • PORT dengan port yang ingin Anda kirimi permintaan. Port default-nya adalah 8080.

YAML

Anda dapat mendownload konfigurasi layanan yang ada ke dalam file YAML dengan perintah gcloud run services describe menggunakan tanda --format=export. Kemudian, Anda dapat mengubah file YAML tersebut dan men-deploy perubahan tersebut dengan perintah gcloud run services replace. Anda harus memastikan bahwa Anda hanya mengubah atribut yang ditentukan.

  1. Download konfigurasi layanan Anda ke file bernama service.yaml di ruang kerja lokal:

    gcloud run services describe SERVICE --format export > service.yaml

    Ganti SERVICE dengan nama layanan Knative serving Anda.

  2. Di file lokal Anda, perbarui atribut containerPort::

    apiVersion: serving.knative.dev/v1
kind: Service
spec:
  template:
    spec:
      containers:
      - image: IMAGE_URL
        ports:
        - containerPort: PORT

    Ganti

    • IMAGE_URL dengan referensi ke image container, misalnya, gcr.io/cloudrun/hello.
    • PORT dengan port yang ingin Anda kirimi permintaan.

  3. Ganti layanan dengan konfigurasi barunya menggunakan perintah berikut:

    gcloud run services replace service.yaml

Mengonfigurasi perintah dan argumen entrypoint container

Setiap perubahan konfigurasi akan menghasilkan revisi baru. Revisi selanjutnya juga akan otomatis mendapatkan setelan konfigurasi ini, kecuali jika Anda melakukan pembaruan eksplisit untuk mengubahnya.

Saat memulai container, layanan Knative akan menjalankan perintah entrypoint default image. Untuk menentukan atau mengganti perintah dan argumen entrypoint yang ada yang ditentukan dalam image container, Anda dapat mengonfigurasi setelan command dan args dalam konfigurasi container penayangan Knative.

Anda dapat memilih untuk mengonfigurasi perintah entrypoint, argumen, atau keduanya. Perintah yang Anda tentukan di penayangan Knative akan menggantikan perintah entrypoint yang ditentukan di image container. Jika Anda memilih untuk hanya menentukan argumen, argumen tersebut akan diteruskan ke dan dijalankan oleh perintah entrypoint yang ditentukan dalam image container.

Di layanan Knative, Anda dapat mengonfigurasi perintah dan argumen entrypoint menggunakan Google Cloud konsol, Google Cloud CLI, atau file YAML saat Anda men-deploy layanan baru, memperbarui layanan yang ada, atau men-deploy revisi:

Konsol

  1. Buka Knative serving di konsol Google Cloud :

    Buka Inferensi Knative

  2. Klik Buat Layanan jika Anda mengonfigurasi layanan baru yang akan di-deploy. Jika Anda mengonfigurasi layanan yang sudah ada, klik layanan tersebut, lalu klik Edit & Deploy Revisi Baru.

  3. Di bagian Setelan lanjutan, klik Penampung.

  4. Tentukan perintah dan argumen entrypoint yang Anda inginkan agar container dijalankan selama startup.

  5. Klik Berikutnya untuk melanjutkan ke bagian berikutnya.

  6. Di bagian Konfigurasi cara layanan ini dipicu, pilih konektivitas yang ingin Anda gunakan untuk memanggil layanan.

  7. Klik Create untuk men-deploy image ke layanan Knative dan tunggu hingga deployment selesai.

Command line

Opsi parameter perintah

  • Untuk menentukan argumen yang berisi koma (,), Anda harus meng-escape setiap ARG dengan pemisah yang berbeda. Misalnya, jika Anda menggunakan @: 
    --args "^@^arg,with,commas@anotherarg@ARG3..."
  • Untuk menentukan beberapa set pasangan nilai kunci, Anda dapat menentukan beberapa parameter agar mudah dibaca. Contoh: 
    [...]
--args "ARG1" \
--args "ARG2" \
--args "ARG3"
  • Untuk menggunakan tanda sama dengan (=) dalam argumen, Anda harus menentukan setiap argumen menggunakan format berikut: 
    gcloud run services ...  \
  --args "--repo-allowlist=github.com/example/example_demo" \
  --args "--gh-webhook-secret=XX"

  • Untuk layanan yang sudah ada, perbarui perintah titik entri dengan menjalankan perintah gcloud run services update dengan parameter berikut:

    gcloud run services update SERVICE --command COMMAND --args ARG1,ARG2,ARG-N

    Ganti:

    • SERVICE dengan nama layanan.
    • Opsional: COMMAND dengan perintah yang Anda inginkan agar container dijalankan saat startup.
    • Opsional: ARG1 dengan satu atau beberapa argumen untuk perintah yang dijalankan selama startup. Gunakan daftar yang dipisahkan koma untuk beberapa argumen. Cara memformat argumen Anda.

  • Untuk layanan baru, tetapkan perintah titik entri dengan menjalankan perintah gcloud run deploy dengan parameter --command:

    gcloud run deploy SERVICE --image=IMAGE_URL --command COMMAND --args ARG1,ARG2,ARG-N

    Ganti:

    • SERVICE dengan nama layanan.
    • IMAGE_URL dengan referensi ke image container, misalnya, gcr.io/cloudrun/hello.
    • Opsional: COMMAND dengan perintah yang Anda inginkan agar container dijalankan saat startup.
    • Opsional: ARG1 dengan satu atau beberapa argumen untuk perintah yang dijalankan selama startup. Gunakan daftar yang dipisahkan koma untuk beberapa argumen. Cara memformat argumen Anda.

YAML

Anda dapat mendownload konfigurasi layanan yang ada ke dalam file YAML dengan perintah gcloud run services describe menggunakan tanda --format=export. Kemudian, Anda dapat mengubah file YAML tersebut dan men-deploy perubahan tersebut dengan perintah gcloud run services replace. Anda harus memastikan bahwa Anda hanya mengubah atribut yang ditentukan.

  1. Download konfigurasi layanan Anda ke file bernama service.yaml di ruang kerja lokal:

    gcloud run services describe SERVICE --format export > service.yaml

    Ganti SERVICE dengan nama layanan Knative serving Anda.

  2. Di file lokal Anda, perbarui atribut command dan args:

    apiVersion: serving.knative.dev/v1
kind: Service
spec:
  template:
    spec:
      containers:
      - image: IMAGE_URL
        command:
        - COMMAND
        args:
        - "ARG1"
        - "ARG-N"

    Ganti:

    • IMAGE_URL dengan referensi ke image container, misalnya, gcr.io/cloudrun/hello.
    • Opsional: COMMAND dengan perintah yang Anda inginkan agar container dijalankan saat startup.
    • Opsional: ARG1 dengan satu atau beberapa argumen untuk perintah yang dijalankan selama startup. Gunakan daftar yang dipisahkan koma untuk lebih dari satu argumen.

  3. Ganti layanan dengan konfigurasi barunya menggunakan perintah berikut:

    gcloud run services replace service.yaml