Traffic keluar VPC langsung dengan jaringan VPC

Konsol

1. Buka Cloud Run

2. Klik Buat Layanan jika Anda mengonfigurasi layanan baru yang akan di-deploy. Jika Anda mengonfigurasi dan men-deploy layanan yang ada, klik layanan, lalu klik Edit and deploy new revision.

3. Jika Anda mengonfigurasi layanan baru, isi halaman setelan layanan awal sesuai kebutuhan, lalu klik Container(s), volume, networking, security untuk memperluas halaman konfigurasi layanan.

4. Klik tab Networking.

5. Klik Hubungkan ke VPC untuk traffic keluar.

6. Klik Kirim traffic langsung ke VPC.

7. Di kolom Network, pilih jaringan VPC yang ingin Anda kirimi traffic.

8. Di kolom Subnet, pilih subnet tempat alamat IP diterima oleh layanan Anda. Anda dapat men-deploy beberapa layanan di subnet yang sama.

9. Opsional: Masukkan nama tag jaringan yang ingin dikaitkan dengan layanan Anda atau layanan lainnya. Tag jaringan ditentukan pada tingkat revisi. Setiap revisi layanan dapat memiliki tag jaringan yang berbeda, seperti network-tag-2.

10. Untuk Pemilihan rute traffic, pilih salah satu opsi berikut:

    • Rutekan hanya permintaan IP pribadi ke VPC untuk hanya mengirim traffic ke alamat internal melalui jaringan VPC.
    • Rutekan semua traffic ke VPC untuk mengirim semua traffic keluar melalui jaringan VPC.

11. Klik Buat atau Deploy.

12. Untuk memverifikasi bahwa layanan Anda sudah berada di jaringan VPC, klik layanan, lalu klik tab Networking. Jaringan dan subnet tercantum dalam kartu VPC.

    Kini Anda dapat mengirim permintaan dari layanan Cloud Run ke resource mana pun di jaringan VPC, sebagaimana diizinkan oleh aturan firewall Anda.

gcloud

Untuk men-deploy layanan Cloud Run tanpa konektor dari Google Cloud CLI:

1. Pastikan Compute Engine API diaktifkan untuk project Anda:

   gcloud services enable compute.googleapis.com
   

2. Deploy layanan Cloud Run Anda dengan perintah berikut:

   gcloud run deploy SERVICE_NAME \
   --image=IMAGE_URL \
   --network=NETWORK \
   --subnet=SUBNET \
   --network-tags=NETWORK_TAG_NAMES \
   --vpc-egress=EGRESS_SETTING \
   --region=REGION
   

   Ganti:

   • SERVICE_NAME dengan nama layanan Cloud Run Anda.
   • IMAGE_URL dengan referensi ke image container, misalnya, us-docker.pkg.dev/cloudrun/container/hello:latest. Jika Anda menggunakan Artifact Registry, repositori REPO_NAME harus sudah dibuat. URL memiliki bentuk LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG
   • NETWORK dengan nama jaringan VPC Anda.
   • SUBNET dengan nama subnet Anda. Anda dapat men-deploy atau menjalankan beberapa layanan atau tugas di subnet yang sama.
   • Opsional: NETWORK_TAG_NAMES dengan nama tag jaringan yang dipisahkan koma yang ingin Anda kaitkan dengan layanan. Untuk layanan, tag jaringan ditentukan pada tingkat revisi. Setiap revisi jaringan dapat memiliki tag jaringan yang berbeda, seperti network-tag-2.
   • EGRESS_SETTING dengan nilai setelan traffic keluar:
     • all-traffic: Mengirim semua traffic keluar melalui jaringan VPC.
     • private-ranges-only: Hanya mengirim traffic ke alamat internal melalui jaringan VPC.
   • REGION dengan region untuk layanan Anda.

3. Untuk memverifikasi bahwa layanan Anda berada di jaringan VPC, jalankan perintah berikut:

   gcloud run services describe SERVICE_NAME \
   --region=REGION
   

   Ganti:

   • SERVICE_NAME dengan nama layanan Anda.
   • REGION dengan region untuk layanan yang Anda tentukan di langkah sebelumnya.

   Output harus berisi nama jaringan, subnet, dan setelan egress, misalnya:

   VPC access:
     Network:       default
     Subnet:        subnet
     Egress:        private-ranges-only
   

Kini Anda dapat mengirim permintaan dari layanan Cloud Run ke resource mana pun di jaringan VPC, sebagaimana diizinkan oleh aturan firewall Anda.

YAML

1. Jika Anda membuat layanan baru, lewati langkah ini. Jika Anda mengupdate layanan yang ada, download konfigurasi YAML:

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

2. Perbarui atribut berikut:

   apiVersion: serving.knative.dev/v1
     kind: Service
     metadata:
       name: SERVICE_NAME
       labels:
         cloud.googleapis.com/location: REGION
     spec:
       template:
         metadata:
           annotations:
             run.googleapis.com/network-interfaces: '[{"network":"NETWORK","subnetwork":"SUBNET","tags":"NETWORK_TAG_NAMES"}]'
             run.googleapis.com/vpc-access-egress: EGRESS_SETTING
         spec:
           containers:
           - image: IMAGE

   Ganti:

   • SERVICE_NAME dengan nama layanan Cloud Run Anda. Nama layanan harus terdiri dari 49 karakter atau kurang dan harus unik per region dan project.
   • REGION dengan region untuk layanan Cloud Run, yang harus sesuai dengan region subnet Anda.
   • NETWORK dengan nama jaringan VPC Anda.
   • SUBNET dengan nama subnet Anda. Anda dapat men-deploy atau menjalankan beberapa layanan atau tugas di subnet yang sama.
   • Opsional NETWORK_TAG_NAMES dengan nama tag jaringan yang ingin Anda kaitkan dengan layanan. Untuk layanan, tag jaringan ditentukan pada tingkat revisi. Setiap revisi jaringan dapat memiliki tag jaringan yang berbeda, seperti network-tag-2.
   • EGRESS_SETTING dengan nilai setelan traffic keluar:
     • all-traffic: Mengirim semua traffic keluar melalui jaringan VPC.
     • private-ranges-only: Hanya mengirim traffic ke alamat internal melalui jaringan VPC.
   • IMAGE dengan URL image container layanan Anda.

   Anda juga dapat menentukan lebih banyak konfigurasi, seperti variabel lingkungan atau batas memori.

3. Buat atau update layanan menggunakan perintah berikut:

   gcloud run services replace service.yaml

Terraform

Untuk mempelajari cara menerapkan atau menghapus konfigurasi Terraform, lihat Perintah dasar Terraform.

1. Tambahkan berikut ini ke file main.tf:

   /**
    * Copyright 2024 Google LLC
    *
    * Licensed under the Apache License, Version 2.0 (the "License");
    * you may not use this file except in compliance with the License.
    * You may obtain a copy of the License at
    *
    *      http://www.apache.org/licenses/LICENSE-2.0
    *
    * Unless required by applicable law or agreed to in writing, software
    * distributed under the License is distributed on an "AS IS" BASIS,
    * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    * See the License for the specific language governing permissions and
    * limitations under the License.
    */
   
   # Example configuration of a Cloud Run service with direct VPC
   
   resource "google_cloud_run_v2_service" "default" {
     name     = "cloudrun-service"
     location = "us-central1"
   
     template {
       containers {
         image = "us-docker.pkg.dev/cloudrun/container/hello"
       }
       vpc_access {
         network_interfaces {
           network    = "default"
           subnetwork = "default"
           tags       = ["tag1", "tag2", "tag3"]
         }
       }
     }
   }
   

Konsol

1. Buka Cloud Run

2. Jika Anda mengonfigurasi tugas baru, klik tab Jobs, lalu isi halaman setelan tugas awal sesuai kebutuhan. Jika Anda mengonfigurasi tugas yang sudah ada, klik tugas, kemudian klik Edit.

3. Klik Container, Variabel, & Rahasia, Koneksi, Keamanan untuk memperluas halaman properti tugas.

4. Klik tab Koneksi.

5. Klik Hubungkan ke VPC untuk traffic keluar.

6. Klik Kirim traffic langsung ke VPC.

7. Di kolom Network, pilih jaringan VPC yang ingin Anda kirimi traffic.

8. Di kolom Subnet, pilih subnet tempat alamat IP diterima oleh tugas Anda. Anda dapat menjalankan beberapa tugas di subnet yang sama.

9. Untuk Pemilihan rute traffic, pilih salah satu opsi berikut:

   • Rutekan hanya permintaan IP pribadi ke VPC untuk hanya mengirim traffic ke alamat internal melalui jaringan VPC.
   • Rutekan semua traffic ke VPC untuk mengirim semua traffic keluar melalui jaringan VPC.

10. Opsional: Masukkan nama tag jaringan yang ingin dikaitkan dengan layanan Anda atau layanan lainnya. Tag jaringan ditentukan pada tingkat revisi. Setiap revisi layanan dapat memiliki tag jaringan yang berbeda, seperti network-tag-2.

11. Opsional: Masukkan nama tag jaringan yang ingin dikaitkan dengan tugas Anda. Untuk tugas, tag jaringan ditentukan pada tingkat eksekusi. Setiap eksekusi tugas dapat memiliki tag jaringan yang berbeda, seperti network-tag-2.

12. Klik Buat atau Perbarui.

13. Untuk memverifikasi bahwa tugas Anda berada di jaringan VPC, klik tugas tersebut, lalu klik tab Configuration. Jaringan dan subnet tercantum dalam kartuVPC.

    Sekarang Anda dapat menjalankan tugas Cloud Run dan mengirim permintaan dari tugas ke resource mana pun di jaringan VPC, sebagaimana diizinkan oleh aturan firewall Anda.

gcloud

Untuk membuat tugas Cloud Run tanpa konektor dari Google Cloud CLI:

1. Pastikan Compute Engine API diaktifkan untuk project Anda:

   gcloud services enable compute.googleapis.com
   

2. Buat tugas Cloud Run dengan perintah berikut:

   gcloud run jobs create JOB_NAME \
   --image=IMAGE_URL \
   --network=NETWORK \
   --subnet=SUBNET \
   --network-tags=NETWORK_TAG_NAMES \
   --vpc-egress=EGRESS_SETTING \
   --region=REGION
   

   Ganti:

   • JOB_NAME dengan nama tugas Cloud Run Anda
   • IMAGE_URL dengan referensi ke image container, misalnya, us-docker.pkg.dev/cloudrun/container/job:latest
   • NETWORK dengan nama jaringan VPC Anda.
   • SUBNET dengan nama subnet Anda. Anda dapat men-deploy atau menjalankan beberapa layanan atau tugas di subnet yang sama.
   • Opsional: NETWORK_TAG_NAMES dengan nama tag jaringan yang ingin Anda kaitkan dengan tugas. Untuk tugas, tag jaringan ditentukan pada tingkat eksekusi. Setiap eksekusi tugas dapat memiliki tag jaringan yang berbeda, seperti network-tag-2.
   • EGRESS_SETTING dengan nilai setelan traffic keluar:
     • all-traffic: Mengirim semua traffic keluar melalui jaringan VPC.
     • private-ranges-only: Hanya mengirim traffic ke alamat internal melalui jaringan VPC.
   • REGION dengan region untuk tugas Anda.

3. Untuk memverifikasi bahwa tugas berada di jaringan VPC Anda, jalankan perintah berikut:

   gcloud run jobs describe JOB_NAME \
     --region=REGION
     

   Ganti:

   • JOB_NAME dengan nama tugas Anda.
   • REGION dengan region untuk tugas yang Anda tentukan di langkah sebelumnya.

   Output harus berisi nama jaringan dan subnet, misalnya:

   VPC network:
     Network:       default
     Subnet:        default
   

Sekarang Anda dapat menjalankan tugas Cloud Run dan mengirim permintaan dari tugas ke resource mana pun di jaringan VPC, sebagaimana diizinkan oleh aturan firewall Anda.

YAML

1. Jika Anda membuat tugas baru, lewati langkah ini. Jika Anda memperbarui tugas yang sudah ada, download Konfigurasi YAML:

   gcloud run jobs describe JOB_NAME --format export > job.yaml

2. Perbarui atribut berikut:

   apiVersion: run.googleapis.com/v1
     kind: Job
     metadata:
       name: JOB_NAME
       annotations:
         run.googleapis.com/launch-stage: BETA
       labels:
         cloud.googleapis.com/location: REGION
     spec:
       template:
         metadata:
           annotations:
             run.googleapis.com/network-interfaces: '[{"network":"NETWORK","subnetwork":"SUBNET","tags":"NETWORK_TAG_NAMES"}]'
             run.googleapis.com/vpc-access-egress: EGRESS_SETTING
         spec:
           containers:
           - image: IMAGE

   Ganti:

   • JOB_NAME dengan nama tugas Cloud Run Anda Nama tugas harus terdiri dari 49 karakter atau kurang dan harus unik per region dan project.
   • REGION dengan region untuk tugas Cloud Run, yang harus sesuai dengan region subnet Anda.
   • NETWORK dengan nama jaringan VPC Anda.
   • SUBNET dengan nama subnet Anda. Anda dapat men-deploy atau menjalankan beberapa layanan atau tugas di subnet yang sama.
   • Opsional: NETWORK_TAG_NAMES dengan nama tag jaringan yang ingin Anda kaitkan dengan tugas. Untuk tugas, tag jaringan ditentukan pada tingkat eksekusi. Setiap eksekusi tugas dapat memiliki tag jaringan yang berbeda, seperti network-tag-2.
   • EGRESS_SETTING dengan nilai setelan traffic keluar:
     • all-traffic: Mengirim semua traffic keluar melalui jaringan VPC.
     • private-ranges-only: Hanya mengirim traffic ke alamat internal melalui jaringan VPC.
   • IMAGE dengan URL image container tugas Anda.

3. Buat atau perbarui tugas menggunakan perintah berikut:

   gcloud run jobs replace job.yaml

Konsol

Untuk mengaitkan tag jaringan dengan layanan atau tugas:

1. Pada konsol Google Cloud, buka halaman Cloud Run.

   Buka Cloud Run

2. Klik layanan atau tugas yang ingin Anda kaitkan dengan tag jaringan, lalu klik Edit and deploy new revision untuk layanan atau Edit untuk tugas tersebut.

3. Klik tab Networking untuk layanan, atau tab Connections untuk tugas.

4. Pastikan Anda telah memilih Hubungkan ke VPC untuk traffic keluar dan Kirim traffic langsung ke VPC.

5. Di kolom Subnet, pilih subnet tempat layanan Anda menerima alamat IP. Anda dapat men-deploy atau menjalankan beberapa layanan atau tugas di subnet yang sama.

6. Di kolom Tag jaringan, masukkan nama tag jaringan yang ingin dikaitkan dengan layanan atau tugas Anda.

7. Klik Deploy atau Update.

Untuk layanan, setiap revisi layanan dapat memiliki kumpulan tag jaringan yang berbeda karena tag jaringan ditentukan pada tingkat revisi. Untuk tugas, eksekusi tugas memiliki tag jaringan yang sama dengan tugas saat eksekusi tugas dibuat.

gcloud

Untuk mengaitkan tag jaringan dengan layanan atau tugas, gunakan perintah gcloud run deploy:

gcloud run deploy SERVICE_JOB_NAME \
    --image=IMAGE_URL \
    --network=NETWORK \
    --subnet=SUBNET \
    --network-tags=NETWORK_TAG_NAMES \
    --region=REGION

Ganti kode berikut:

• SERVICE_JOB_NAME dengan nama layanan atau pekerjaan Anda.
• IMAGE_URL dengan URL gambar layanan atau tugas.
• NETWORK dengan nama jaringan VPC Anda.
• SUBNET dengan nama subnet Anda. Anda dapat men-deploy atau menjalankan beberapa layanan atau tugas di subnet yang sama.
• NETWORK_TAG_NAMES dengan nama tag jaringan Anda atau daftar tag jaringan yang dipisahkan koma.
• REGION dengan nama wilayah Anda.

Untuk layanan, setiap revisi layanan dapat memiliki kumpulan tag jaringan yang berbeda karena tag jaringan ditentukan pada tingkat revisi. Untuk tugas, eksekusi tugas memiliki tag jaringan yang sama dengan tugas saat eksekusi tugas dibuat.

Konsol

• Untuk menghapus layanan Anda dari jaringan VPC:

  1. Buka Cloud Run

  2. Klik layanan yang ingin Anda hapus, lalu klik Edit and deploy new revision.

  3. Klik tab Networking.

  4. Hapus Menghubungkan ke VPC untuk traffic keluar.

  5. Klik Deploy.

  6. Untuk memverifikasi bahwa layanan Anda tidak lagi berada di jaringan VPC, klik tab Networking. Jaringan dan subnet tidak lagi tercantum dalam kartu VPC.

• Untuk menghapus tag jaringan saja dan menjaga layanan tetap terhubung ke jaringan VPC:

  1. Klik layanan berisi tag jaringan yang ingin Anda hapus, lalu klik Edit and deploy new revision.

  2. Klik tab Networking.

  3. Hapus nama tag jaringan yang tidak ingin dikaitkan lagi dengan layanan Anda.

  4. Klik Deploy.

gcloud

• Untuk menghapus layanan Anda dari jaringan VPC, jalankan perintah berikut:

  gcloud run services update SERVICE_NAME --region=REGION \
  --clear-network
  

• Untuk menghapus tag jaringan saja dan menjaga layanan tetap terhubung ke jaringan VPC, jalankan perintah berikut:

  gcloud run services update SERVICE_NAME --region=REGION \
  --clear-network-tags
  

  Ganti kode berikut:

  • SERVICE_NAME: nama layanan Cloud Run Anda.
  • REGION: region untuk layanan Cloud Run Anda.

YAML

• Untuk menghapus layanan Anda dari jaringan VPC:

  1. Download konfigurasi YAML layanan:

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

  2. Hapus konten tersebut dari file service.yaml Anda:

     run.googleapis.com/network-interfaces: '[{"network":"NETWORK","subnetwork":"SUBNET","tags":"NETWORK_TAG_NAMES"}]'

     Dengan

     • NETWORK: nama jaringan VPC Anda.
     • SUBNET: nama subnet Anda.
     • Opsional: NETWORK_TAG_NAMES: nama tag jaringan apabila Anda ingin mengaitkannya dengan layanan.

  3. Deploy revisi layanan dengan menjalankan perintah berikut:

     gcloud run services replace service.yaml

• Untuk menghapus tag jaringan saja dan menjaga layanan tetap terhubung ke jaringan VPC:

  1. Download konfigurasi YAML layanan:

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

  2. Hapus variabel tags dari konten dalam file service.yaml, dengan membiarkan variabel network dan subnetwork tetap di tempatnya, seperti yang ditunjukkan dalam contoh berikut:

     run.googleapis.com/network-interfaces: '[{"network":"NETWORK","subnetwork":"SUBNET"}]'

     Dengan

     • NETWORK: nama jaringan VPC Anda.
     • SUBNET: nama subnet Anda.

  3. Deploy revisi layanan dengan menjalankan perintah berikut:

     gcloud run services replace service.yaml

Konsol

• Untuk menghapus tugas Anda dari jaringan VPC:

  1. Buka Cloud Run

  2. Klik tugas yang ingin Anda hapus, lalu klik Edit and deploy new revision.

  3. Klik tab Koneksi.

  4. Hapus Hubungkan ke VPC untuk traffic keluar.

  5. Klik Perbarui.

  6. Untuk memverifikasi bahwa tugas Anda tidak lagi berada di jaringan VPC, klik tab Konfigurasi. Jaringan dan subnet tidak lagi tercantum dalam kartu VPC.

• Untuk menghapus tag jaringan saja dan menjaga tugas tetap terhubung ke jaringan VPC:

  1. Klik tugas yang berisi tag jaringan yang ingin Anda hapus, lalu klik Edit and deploy new revision.

  2. Klik tab Koneksi.

  3. Hapus nama tag jaringan yang tidak ingin dikaitkan lagi dengan tugas Anda.

  4. Klik Perbarui.

gcloud

• Untuk menghapus tugas Anda dari jaringan VPC, jalankan perintah berikut:

  gcloud run jobs update JOB_NAME --region=REGION \
    --clear-network
    

• Untuk menghapus tag jaringan saja dan menjaga tugas tetap terhubung ke jaringan VPC, jalankan perintah berikut:

  gcloud run jobs update JOB_NAME --region=REGION \
    --clear-network-tags
    

  Ganti kode berikut:

  • JOB_NAME: nama tugas Cloud Run Anda.
  • REGION: region untuk tugas Cloud Run Anda.

YAML

• Untuk menghapus tugas Anda dari jaringan VPC:

  1. Download konfigurasi YAML tugas:

     gcloud run jobs describe JOB_NAME --format export > job.yaml

  2. Hapus konten tersebut dari file job.yaml Anda:

     run.googleapis.com/network-interfaces: '[{"network":"NETWORK","subnetwork":"SUBNET","tags":"NETWORK_TAG_NAMES"}]'

     Ganti kode berikut:

     • NETWORK: nama jaringan VPC Anda.
     • SUBNET: nama subnet Anda.
     • Opsional: NETWORK_TAG_NAMES dengan nama tag jaringan jika Anda telah mengaitkannya dengan tugas.

  3. Perbarui tugas dengan menjalankan perintah berikut:

     gcloud run jobs replace job.yaml

• Untuk menghapus tag jaringan saja dan menjaga tugas tetap terhubung ke jaringan VPC:

  1. Download konfigurasi YAML tugas:

     gcloud run jobs describe JOB_NAME --format export > job.yaml

  2. Hapus variabel tags dari konten dalam file job.yaml, dengan membiarkan variabel network dan subnetwork tetap di tempatnya, seperti yang ditunjukkan dalam contoh berikut:

     run.googleapis.com/network-interfaces: '[{"network":"NETWORK","subnetwork":"SUBNET"}]'

     Ganti kode berikut:

     • NETWORK: nama jaringan VPC Anda.
     • SUBNET: nama subnet Anda.

  3. Perbarui tugas dengan menjalankan perintah berikut:

     gcloud run jobs replace job.yaml