Terhubung ke jaringan VPC

Konsol

1. Buka halaman ringkasan Akses VPC Serverless.

   Buka Akses VPC Serverless

2. Klik Create connector.

3. Di kolom Nama, masukkan nama untuk konektor Anda, yang cocok dengan Penamaan Compute Engine yang sesuai, dengan persyaratan tambahan bahwa nama harus kurang dari 21 panjang karakter, dan tanda hubung (-) dihitung sebagai dua karakter.

4. Di kolom Region, pilih region untuk konektor Anda. Region ini harus cocok dengan region layanan serverless Anda.

   Jika layanan atau tugas Anda berada di region us-central atau europe-west, gunakan us-central1 atau europe-west1.

5. Di kolom Jaringan, pilih jaringan VPC yang akan dipasangkan konektor.

6. Pada kolom Subnet pilih salah satu opsi berikut:

   • Buat konektor menggunakan subnet yang ada: Pilih konektor yang ada di kolom Subnet.

   • Buat konektor dan subnet baru: Pilih Rentang IP kustom di di kolom Subnet. Kemudian, masukkan alamat pertama di /28 yang tidak digunakan CIDR (misalnya 10.8.0.0/28) yang akan digunakan sebagai alamat IPv4 utama rentang subnet baru yang dibuat Google Cloud di antarmuka Jaringan VPC. Pastikan rentang IP tidak bertentangan dengan rute yang ada di jaringan VPC konektor. Nama subnet baru dimulai dengan "aet-" .

7. (Opsional) Guna menetapkan opsi penskalaan untuk mendapatkan kontrol tambahan atas konektor, klik Tampilkan Setelan Penskalaan untuk menampilkan formulir penskalaan.

   1. Tetapkan jumlah minimum dan maksimum instance untuk konektor Anda, atau gunakan default, yaitu 2 (minimum) dan 10 (maksimum). Tujuan konektor diskalakan hingga jumlah maksimum yang ditentukan jika penggunaan traffic memerlukan tetapi konektor tidak menurunkan skala saat traffic menurun. Anda harus menggunakan nilai antara 2 dan 10.
   2. Di menu Jenis Instance, pilih jenis mesin yang akan digunakan untuk konektor, atau gunakan e2-micro default. Perhatikan sidebar biaya di sisi kanan saat Anda memilih jenis instance, yang menampilkan estimasi biaya dan bandwidth.

8. Klik Buat.

9. Tanda centang berwarna hijau akan muncul di samping nama konektor saat konektor siap digunakan.

gcloud

1. Di konsol Google Cloud, aktifkan Cloud Shell.

   Aktifkan Cloud Shell

   Di bagian bawah Google Cloud Console, Cloud Shell sesi akan terbuka dan menampilkan perintah command line. Cloud Shell adalah lingkungan shell dengan Google Cloud CLI yang sudah terinstal, dan dengan nilai yang sudah ditetapkan untuk project Anda saat ini. Diperlukan waktu beberapa detik untuk melakukan inisialisasi sesi.

2. Update komponen gcloud ke versi terbaru:

   gcloud components update
   

3. Pastikan API Akses VPC Serverless diaktifkan untuk project Anda:

   gcloud services enable vpcaccess.googleapis.com
   

4. Buat konektor menggunakan salah satu opsi berikut:

   Untuk detail selengkapnya dan argumen opsional, lihat gcloud referensi.

   • Buat konektor menggunakan subnet yang ada:

     gcloud compute networks vpc-access connectors create CONNECTOR_NAME \
      --region REGION \
      --subnet SUBNET_NAME \
      --subnet-project HOST_PROJECT_ID \
      --min-instances MIN \
      --max-instances MAX \
      --machine-type MACHINE_TYPE
     

     Ganti kode berikut:

     • CONNECTOR_NAME: nama untuk konektor Anda, penamaan Compute Engine yang cocok yang sesuai, dengan persyaratan tambahan bahwa nama harus kurang dari 21 panjang karakter, dan tanda hubung (-) dihitung sebagai dua karakter.
     • REGION: region untuk konektor Anda, yang cocok dengan region layanan atau tugas serverless Anda. Jika layanan atau pekerjaan Anda di us-central atau europe-west, gunakan us-central1 atau europe-west1.
     • SUBNET_NAME: nama subnet yang ada.
     • HOST_PROJECT_ID: host VPC Bersama project ID Anda. Jika konektor dan subnet yang ada berada project yang sama, hapus flag --subnet-project.
     • MIN: jumlah minimum instance yang akan digunakan ke konektor. Gunakan bilangan bulat antara 2(default) dan 9.
     • MAX: jumlah maksimum instance yang akan digunakan ke konektor. Gunakan bilangan bulat antara 3 dan 10 (default). Jika konektor menskalakan hingga jumlah maksimum instance, akan tidak menurunkan skala.
     • MACHINE_TYPE: harus salah satu dari berikut ini: f1-micro, e2-micro, atau e2-standard-4.

   • Buat konektor dan subnet baru:

     gcloud compute networks vpc-access connectors create CONNECTOR_NAME \
      --region REGION \
      --network VPC_NETWORK \
      --range IP_RANGE
      --min-instances MIN \
      --max-instances MAX \
      --machine-type MACHINE_TYPE
     

     Ganti kode berikut:

     • CONNECTOR_NAME: nama untuk konektor Anda, penamaan Compute Engine yang cocok yang sesuai, dengan persyaratan tambahan bahwa nama harus kurang dari 21 panjang karakter, dan tanda hubung (-) dihitung sebagai dua karakter.
     • REGION: region untuk konektor Anda, yang cocok dengan region layanan atau tugas serverless Anda. Jika layanan atau pekerjaan Anda di us-central atau europe-west, gunakan us-central1 atau europe-west1.
     • VPC_NETWORK: nama VPC jaringan tempat konektor Anda dipasang. Konektor dan Jaringan VPC harus ditempatkan di project yang sama.
     • IP_RANGE: memberikan CIDR /28 yang tidak digunakan (untuk contoh 10.8.0.0/28) untuk digunakan sebagai rentang alamat IPv4 utama dari subnet baru yang dibuat Google Cloud di antarmuka Jaringan VPC. Pastikan rentang IP tidak bentrok dengan rute yang ada di rute konektor Jaringan VPC. Nama subnet baru dimulai dengan "aet-" .
     • MIN: jumlah minimum instance yang akan digunakan ke konektor. Gunakan bilangan bulat antara 2(default) dan 9.
     • MAX: jumlah maksimum instance yang akan digunakan ke konektor. Gunakan bilangan bulat antara 3 dan 10 (default). Jika konektor menskalakan hingga jumlah maksimum instance, akan tidak menurunkan skala.
     • MACHINE_TYPE: harus salah satu dari berikut ini: f1-micro, e2-micro, atau e2-standard-4.

5. Pastikan konektor Anda berstatus READY sebelum menggunakannya:

   gcloud compute networks vpc-access connectors describe CONNECTOR_NAME \
   --region REGION
   

   Ganti kode berikut:

   • CONNECTOR_NAME: nama konektor Anda; ini adalah nama yang Anda tentukan pada langkah sebelumnya.
   • REGION: region konektor Anda; ini adalah region yang Anda tentukan pada langkah sebelumnya.

   Output harus berisi baris state: READY.

Terraform

Anda dapat menggunakan resource Terraform untuk mengaktifkan vpcaccess.googleapis.com API.

resource "google_project_service" "vpcaccess-api" {
  project = var.project_id # Replace this with your project ID in quotes
  service = "vpcaccess.googleapis.com"
}

Anda dapat menggunakan modul Terraform untuk membuat jaringan VPC dan subnet, lalu membuat konektor 20%.

module "test-vpc-module" {
  source       = "terraform-google-modules/network/google"
  version      = "~> 9.0"
  project_id   = var.project_id # Replace this with your project ID in quotes
  network_name = "my-serverless-network"
  mtu          = 1460

  subnets = [
    {
      subnet_name   = "serverless-subnet"
      subnet_ip     = "10.10.10.0/28"
      subnet_region = "us-central1"
    }
  ]
}

module "serverless-connector" {
  source     = "terraform-google-modules/network/google//modules/vpc-serverless-connector-beta"
  version    = "~> 9.0"
  project_id = var.project_id
  vpc_connectors = [{
    name        = "central-serverless"
    region      = "us-central1"
    subnet_name = module.test-vpc-module.subnets["us-central1/serverless-subnet"].name
    # host_project_id = var.host_project_id # Specify a host_project_id for shared VPC
    machine_type  = "e2-standard-4"
    min_instances = 2
    max_instances = 7
    }
    # Uncomment to specify an ip_cidr_range
    #   , {
    #     name          = "central-serverless2"
    #     region        = "us-central1"
    #     network       = module.test-vpc-module.network_name
    #     ip_cidr_range = "10.10.11.0/28"
    #     subnet_name   = null
    #     machine_type  = "e2-standard-4"
    #     min_instances = 2
    #   max_instances = 7 }
  ]
  depends_on = [
    google_project_service.vpcaccess-api
  ]
}

Konsol

1. Di konsol Google Cloud, buka Cloud Run:

   Buka Cloud Run

2. Klik Deploy container lalu pilih Service untuk mengonfigurasi layanan baru. Jika Anda mengonfigurasi layanan yang ada, klik service, lalu klik Edit and deploy new revision.

3. Jika Anda mengonfigurasi layanan baru, isi layanan awal halaman setelan, lalu klik Container, volume, networking, security untuk meluaskan konfigurasi layanan Google Cloud.

4. Klik tab Koneksi.

   

   • Di kolom VPC Connector, pilih konektor yang akan digunakan atau pilih None untuk memutuskan koneksi layanan Anda dari jaringan VPC.

5. Klik Buat atau Deploy.

gcloud

1. Di konsol Google Cloud, aktifkan Cloud Shell.

   Aktifkan Cloud Shell

   Di bagian bawah Google Cloud Console, Cloud Shell sesi akan terbuka dan menampilkan perintah command line. Cloud Shell adalah lingkungan shell dengan Google Cloud CLI yang sudah terinstal, dan dengan nilai yang sudah ditetapkan untuk project Anda saat ini. Diperlukan waktu beberapa detik untuk melakukan inisialisasi sesi.

2. Untuk menentukan konektor selama proses deployment, gunakan flag --vpc-connector:

   gcloud run deploy SERVICE --image IMAGE_URL --vpc-connector CONNECTOR_NAME

   • Ganti SERVICE dengan nama layanan Anda.
   • Ganti IMAGE_URL.
   • Ganti CONNECTOR_NAME dengan nama konektor Anda. Jika konektor Anda berada dalam project host VPC Bersama, maka nama tersebut harus sepenuhnya ditentukan, misalnya:

     projects/HOST_PROJECT_ID/locations/CONNECTOR_REGION/connectors/CONNECTOR_NAME

     dengan HOST_PROJECT_ID adalah ID project host, CONNECTOR_REGION adalah region konektor Anda, dan CONNECTOR_NAME adalah nama yang Anda berikan ke konektor.

   Untuk memasang, memperbarui, atau menghapus konektor dari layanan yang ada, gunakan perintah gcloud run services update dengan salah satu flag berikut sesuai kebutuhan:

   • --vpc-connector
   • --clear-vpc-connector

   Misalnya, untuk memasang atau memperbarui konektor:

   gcloud run services update SERVICE --vpc-connector CONNECTOR_NAME

   • Ganti SERVICE dengan nama layanan Anda.
   • Ganti CONNECTOR_NAME dengan nama konektor Anda.

YAML

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

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

2. Tambahkan atau perbarui atribut run.googleapis.com/vpc-access-connector di bagian annotations pada atribut spec level teratas:

   apiVersion: serving.knative.dev/v1
   kind: Service
   metadata:
     name: SERVICE
   spec:
     template:
       metadata:
         annotations:
           run.googleapis.com/vpc-access-connector: CONNECTOR_NAME

   • Ganti SERVICE dengan nama layanan Cloud Run Anda
   • Ganti CONNECTOR_NAME dengan nama konektor Anda. Jika konektor Anda berada dalam project host VPC Bersama, maka nama tersebut harus sepenuhnya ditentukan, misalnya:

     projects/HOST_PROJECT_ID/locations/CONNECTOR_REGION/connectors/CONNECTOR_NAME

     dengan HOST_PROJECT_ID adalah ID project host, CONNECTOR_REGION adalah region konektor Anda, dan CONNECTOR_NAME adalah nama yang Anda berikan ke konektor.

3. Ganti layanan dengan konfigurasi barunya menggunakan perintah berikut:

   gcloud beta run services replace service.yaml

Terraform

Anda dapat menggunakan resource Terraform untuk membuat layanan dan mengonfigurasinya untuk menggunakan konektor Anda.

# Cloud Run service
resource "google_cloud_run_v2_service" "gcr_service" {
  name     = "mygcrservice"
  provider = google-beta
  location = "us-west1"

  template {
    containers {
      image = "us-docker.pkg.dev/cloudrun/container/hello"
      resources {
        limits = {
          cpu    = "1000m"
          memory = "512Mi"
        }
      }
      # the service uses this SA to call other Google Cloud APIs
      # service_account_name = myservice_runtime_sa
    }

    scaling {
      # Limit scale up to prevent any cost blow outs!
      max_instance_count = 5
    }

    vpc_access {
      # Use the VPC Connector
      connector = google_vpc_access_connector.connector.id
      # all egress from the service should go through the VPC Connector
      egress = "ALL_TRAFFIC"
    }
  }
}

Konsol

1. Buka halaman ringkasan fungsi Cloud Run di Konsol Google Cloud:

   Buka fungsi Cloud Run

2. Klik Create function. Atau, klik fungsi yang ada untuk membuka halaman detailnya dan klik Edit.

3. Perluas setelan lanjutan dengan mengklik RUNTIME, BUILD AND CONNECTIONS SETTINGS.

4. Di tab Koneksi di bagian Setelan keluar, masukkan nama konektor Anda di kolom Konektor VPC.

gcloud

1. Di konsol Google Cloud, aktifkan Cloud Shell.

   Aktifkan Cloud Shell

   Di bagian bawah Google Cloud Console, Cloud Shell sesi akan terbuka dan menampilkan perintah command line. Cloud Shell adalah lingkungan shell dengan Google Cloud CLI yang sudah terinstal, dan dengan nilai yang sudah ditetapkan untuk project Anda saat ini. Diperlukan waktu beberapa detik untuk melakukan inisialisasi sesi.

2. Gunakan perintah gcloud functions deploy untuk men-deploy fungsi tersebut dan menentukan flag --vpc-connector:

   gcloud functions deploy FUNCTION_NAME \
   --vpc-connector CONNECTOR_NAME \
   FLAGS...
   

   dengan:

   • FUNCTION_NAME adalah nama fungsi Anda.
   • CONNECTOR_NAME adalah nama konektor Anda. Jika konektor Anda berada dalam project host VPC Bersama, maka nama tersebut harus sepenuhnya ditentukan, misalnya:

     projects/HOST_PROJECT_ID/locations/CONNECTOR_REGION/connectors/CONNECTOR_NAME

     dengan HOST_PROJECT_ID adalah ID project host, CONNECTOR_REGION adalah region konektor Anda, dan CONNECTOR_NAME adalah nama yang Anda berikan ke konektor.
   • FLAGS... merujuk pada flag lain yang Anda teruskan selama deployment fungsi.

Python 2

1. Hentikan penggunaan layanan URL-fetch App Engine.

   Secara default, semua permintaan dirutekan melalui layanan URL Fetch. Hal ini menyebabkan permintaan ke jaringan VPC Anda gagal. Untuk menonaktifkan default ini, lihat Menonaktifkan URL Fetch agar tidak menangani semua permintaan keluar.

   Anda masih dapat menggunakan library urlfetch secara langsung untuk setiap permintaan jika diperlukan, tetapi hal ini tidak direkomendasikan.

2. Tambahkan kolom Akses VPC Serverless ke file app.yaml Anda:

   vpc_access_connector:
    name: projects/PROJECT_ID/locations/REGION/connectors/CONNECTOR_NAME
   

   Ganti kode berikut:

   • PROJECT_ID dengan project ID Google Cloud Anda. Jika konektor Anda berada dalam project host VPC Bersama, ID ini harus merupakan ID project host.
   • REGION dengan region tempat konektor Anda berada.
   • CONNECTOR_NAME dengan nama konektor Anda.

3. Men-deploy layanan:

   gcloud app deploy

   Layanan yang telah Anda deploy dapat mengirim permintaan ke alamat IP internal untuk mengakses resource di jaringan VPC Anda.

Java 8

1. Hentikan penggunaan layanan URL-fetch App Engine URLFetchService.

2. Tambahkan elemen Akses VPC Serverless ke file appengine-web.xml layanan Anda:

   <vpc-access-connector>
   <name>projects/PROJECT_ID/locations/REGION/connectors/CONNECTOR_NAME</name>
   </vpc-access-connector>
   

   Ganti kode berikut:

   • PROJECT_ID dengan project ID Google Cloud Anda. Jika konektor Anda berada dalam project host VPC Bersama, ID ini harus merupakan ID project host.
   • REGION dengan region tempat konektor Anda berada.
   • CONNECTOR_NAME dengan nama konektor Anda.

3. Men-deploy layanan:

   gcloud app deploy WEB-INF/appengine-web.xml

   Layanan yang telah Anda deploy dapat mengirim permintaan ke alamat IP internal untuk mengakses resource di jaringan VPC Anda.

Go 1.11

1. Hentikan penggunaan layanan URL-fetch App Engine.

   Akses VPC Serverless tidak mendukung URL Fetch, dan permintaan yang dibuat menggunakan URL Fetch akan mengabaikan setelan Akses VPC Serverless. Buat koneksi keluar dengan soket sebagai gantinya.

2. Tambahkan kolom Akses VPC Serverless ke file app.yaml Anda:

   vpc_access_connector:
    name: projects/PROJECT_ID/locations/REGION/connectors/CONNECTOR_NAME
   

   Ganti kode berikut:

   • PROJECT_ID dengan project ID Google Cloud Anda
   • REGION dengan region tempat konektor Anda berada
   • CONNECTOR_NAME dengan nama konektor Anda

3. Men-deploy layanan:

   gcloud app deploy

   Layanan yang telah Anda deploy dapat mengirim permintaan ke alamat IP internal untuk mengakses resource di jaringan VPC Anda.

Semua runtime lainnya

1. Tambahkan kolom Akses VPC Serverless ke file app.yaml Anda:

   vpc_access_connector:
    name: projects/PROJECT_ID/locations/REGION/connectors/CONNECTOR_NAME
   

   Ganti kode berikut:

   • PROJECT_ID dengan project ID Google Cloud Anda. Jika konektor Anda berada dalam project host VPC Bersama, ID ini harus merupakan ID project host.
   • REGION dengan region tempat konektor Anda berada.
   • CONNECTOR_NAME dengan nama konektor Anda.

2. Men-deploy layanan:

   gcloud app deploy

   Layanan yang telah Anda deploy dapat mengirim permintaan ke alamat IP internal untuk mengakses resource di jaringan VPC Anda.

Network tags

Langkah-langkah berikut menunjukkan cara membuat aturan traffic masuk yang membatasi akses konektor ke jaringan VPC berdasarkan tag jaringan konektor.

1. Pastikan Anda memiliki izin yang diperlukan untuk menyisipkan aturan firewall. Anda harus memiliki salah satu peran Identity and Access Management (IAM) berikut:

   • Peran Compute Security Admin
   • Peran IAM kustom dengan izin compute.firewalls.create diaktifkan

2. Tolak traffic konektor di seluruh jaringan VPC Anda.

   Buat aturan firewall traffic masuk dengan prioritas di bawah 1000 di jaringan VPC Anda untuk menolak traffic masuk dari tag jaringan konektor. Aturan ini akan menggantikan aturan firewall implisit yang secara default dibuat oleh Akses VPC Serverless di jaringan VPC Anda secara default.

   gcloud compute firewall-rules create RULE_NAME \
   --action=DENY \
   --rules=PROTOCOL \
   --source-tags=VPC_CONNECTOR_NETWORK_TAG \
   --direction=INGRESS \
   --network=VPC_NETWORK \
   --priority=PRIORITY
   

   Ganti kode berikut:

   • RULE_NAME: nama aturan firewall baru. Contoh, deny-vpc-connector.

   • PROTOCOL: satu atau beberapa protokol yang ingin Anda izinkan dari konektor VPC. Protokol yang didukung adalah tcp atau udp. Misalnya, tcp:80,udp mengizinkan traffic TCP melalui port 80 dan traffic UDP. Untuk mengetahui informasi selengkapnya, lihat dokumentasi untuk flag allow.

     Untuk tujuan keamanan dan validasi, Anda juga dapat mengonfigurasi aturan penolakan guna memblokir traffic untuk protokol yang tidak didukung berikut: ah, all, esp, icmp, ipip, dan sctp.

   • VPC_CONNECTOR_NETWORK_TAG: tag jaringan konektor universal jika Anda ingin membatasi akses untuk semua konektor (termasuk konektor yang dibuat di masa mendatang), atau tag jaringan unik jika Anda ingin membatasi akses untuk konektor tertentu.

     • Tag jaringan universal: vpc-connector

     • Tag jaringan unik: vpc-connector-REGION-CONNECTOR_NAME

       Ganti:

       • REGION: region konektor yang ingin Anda batasi
       • CONNECTOR_NAME: nama konektor yang ingin Anda batasi

     Untuk mempelajari tag jaringan konektor lebih lanjut, lihat Tag jaringan.

   • VPC_NETWORK: nama jaringan VPC

   • PRIORITY: bilangan bulat antara 0-65535. Misalnya, 0 ditetapkan sebagai prioritas tertinggi.

3. Izinkan traffic konektor ke resource yang akan menerima traffic konektor.

   Gunakan flag allow dan target-tags untuk membuat aturan firewall traffic masuk yang menargetkan resource di jaringan VPC yang Anda inginkan untuk diakses oleh konektor VPC. Tetapkan prioritas untuk aturan ini ke nilai yang lebih rendah daripada prioritas aturan yang Anda buat di langkah sebelumnya.

   gcloud compute firewall-rules create RULE_NAME \
   --allow=PROTOCOL \
   --source-tags=VPC_CONNECTOR_NETWORK_TAG \
   --direction=INGRESS \
   --network=VPC_NETWORK \
   --target-tags=RESOURCE_TAG \
   --priority=PRIORITY
   

   Ganti kode berikut:

   • RULE_NAME: nama aturan firewall baru. Contoh, allow-vpc-connector-for-select-resources.

   • PROTOCOL: satu atau beberapa protokol yang ingin Anda izinkan dari konektor VPC. Protokol yang didukung adalah tcp atau udp. Misalnya, tcp:80,udp mengizinkan traffic TCP melalui port 80 dan traffic UDP. Untuk mengetahui informasi selengkapnya, lihat dokumentasi untuk flag allow.

   • VPC_CONNECTOR_NETWORK_TAG: tag jaringan konektor universal jika Anda ingin membatasi akses untuk semua konektor (termasuk konektor yang dibuat di masa mendatang), atau tag jaringan unik jika Anda ingin membatasi akses untuk konektor tertentu. Tag ini harus sama dengan tag jaringan yang Anda tentukan di langkah sebelumnya.

     • Tag jaringan universal: vpc-connector

     • Tag jaringan unik: vpc-connector-REGION-CONNECTOR_NAME

       Ganti:

       • REGION: region konektor yang ingin Anda batasi
       • CONNECTOR_NAME: nama konektor yang ingin Anda batasi

     Untuk mempelajari tag jaringan konektor lebih lanjut, lihat Tag jaringan.

   • VPC_NETWORK: nama jaringan VPC Anda

   • RESOURCE_TAG: tag jaringan untuk resource VPC yang Anda inginkan untuk diakses oleh konektor VPC

   • PRIORITY: bilangan bulat yang lebih kecil daripada prioritas yang Anda tetapkan pada langkah sebelumnya. Misalnya, jika Anda menetapkan prioritas untuk aturan yang dibuat di langkah sebelumnya ke 990, coba 980.

Untuk informasi selengkapnya tentang flag wajib dan opsional dalam membuat aturan firewall, baca dokumentasi untuk gcloud compute firewall-rules create.

Rentang CIDR

Langkah-langkah berikut menunjukkan cara membuat aturan traffic masuk yang membatasi akses konektor ke jaringan VPC berdasarkan rentang CIDR konektor.

1. Pastikan Anda memiliki izin yang diperlukan untuk menyisipkan aturan firewall. Anda harus memiliki salah satu peran Identity and Access Management (IAM) berikut:

   • Peran Compute Security Admin
   • Peran IAM kustom dengan izin compute.firewalls.create diaktifkan

2. Tolak traffic konektor di seluruh jaringan VPC Anda.

   Buat aturan firewall traffic masuk dengan prioritas di bawah 1000 di jaringan VPC Anda untuk menolak traffic masuk dari rentang CIDR konektor. Aturan ini akan menggantikan aturan firewall implisit yang secara default dibuat oleh Akses VPC Serverless di jaringan VPC Anda secara default.

   gcloud compute firewall-rules create RULE_NAME \
   --action=DENY \
   --rules=PROTOCOL \
   --source-ranges=VPC_CONNECTOR_CIDR_RANGE \
   --direction=INGRESS \
   --network=VPC_NETWORK \
   --priority=PRIORITY
   

   Ganti kode berikut:

   • RULE_NAME: nama aturan firewall baru. Contoh, deny-vpc-connector.

   • PROTOCOL: satu atau beberapa protokol yang ingin Anda izinkan dari konektor VPC. Protokol yang didukung adalah tcp atau udp. Misalnya, tcp:80,udp mengizinkan traffic TCP melalui port 80 dan traffic UDP. Untuk mengetahui informasi selengkapnya, lihat dokumentasi untuk flag allow.

     Untuk tujuan keamanan dan validasi, Anda juga dapat mengonfigurasi aturan penolakan guna memblokir traffic untuk protokol yang tidak didukung berikut: ah, all, esp, icmp, ipip, dan sctp.

   • VPC_CONNECTOR_CIDR_RANGE: rentang CIDR untuk konektor yang aksesnya Anda batasi

   • VPC_NETWORK: nama jaringan VPC Anda

   • PRIORITY: bilangan bulat antara 0-65535. Misalnya, 0 ditetapkan sebagai prioritas tertinggi.

3. Izinkan traffic konektor ke resource yang akan menerima traffic konektor.

   Gunakan flag allow dan target-tags untuk membuat aturan firewall traffic masuk yang menargetkan resource di jaringan VPC yang Anda inginkan untuk diakses oleh konektor VPC. Tetapkan prioritas untuk aturan ini ke nilai yang lebih rendah daripada prioritas aturan yang Anda buat di langkah sebelumnya.

   gcloud compute firewall-rules create RULE_NAME \
   --allow=PROTOCOL \
   --source-ranges=VPC_CONNECTOR_CIDR_RANGE \
   --direction=INGRESS \
   --network=VPC_NETWORK \
   --target-tags=RESOURCE_TAG \
   --priority=PRIORITY
   

   Ganti kode berikut:

   • RULE_NAME: nama aturan firewall baru. Contoh, allow-vpc-connector-for-select-resources.

   • PROTOCOL: satu atau beberapa protokol yang ingin Anda izinkan dari konektor VPC. Protokol yang didukung adalah tcp atau udp. Misalnya, tcp:80,udp mengizinkan traffic TCP melalui port 80 dan traffic UDP. Untuk mengetahui informasi selengkapnya, lihat dokumentasi untuk flag allow.

   • VPC_CONNECTOR_CIDR_RANGE: rentang CIDR untuk konektor yang aksesnya Anda batasi

   • VPC_NETWORK: nama jaringan VPC Anda

   • RESOURCE_TAG: tag jaringan untuk resource VPC yang Anda inginkan untuk diakses oleh konektor VPC

   • PRIORITY: bilangan bulat yang lebih kecil daripada prioritas yang Anda tetapkan pada langkah sebelumnya. Misalnya, jika Anda menetapkan prioritas untuk aturan yang dibuat di langkah sebelumnya ke 990, coba 980.

Untuk informasi selengkapnya tentang flag wajib dan opsional dalam membuat aturan firewall, lihat dokumentasi untuk gcloud compute firewall-rules create.

Konsol

1. Buka halaman ringkasan Akses VPC Serverless.

   Buka Akses VPC Serverless

2. Pilih konektor yang ingin Anda edit, lalu klik Edit.

3. Dalam daftar Jenis instance, pilih jenis mesin (instance) yang Anda inginkan. Untuk mempelajari jenis mesin yang tersedia, baca dokumentasi tentang Throughput dan penskalaan.

gcloud

1. Di konsol Google Cloud, aktifkan Cloud Shell.

   Aktifkan Cloud Shell

   Di bagian bawah Google Cloud Console, Cloud Shell sesi akan terbuka dan menampilkan perintah command line. Cloud Shell adalah lingkungan shell dengan Google Cloud CLI yang sudah terinstal, dan dengan nilai yang sudah ditetapkan untuk project Anda saat ini. Diperlukan waktu beberapa detik untuk melakukan inisialisasi sesi.

2. Untuk mengupdate jenis mesin konektor, jalankan perintah berikut di terminal Anda:

   gcloud beta compute networks vpc-access connectors update CONNECTOR_NAME --region=REGION --machine-type=MACHINE_TYPE
   

   Ganti yang berikut:
   • CONNECTOR_NAME: nama konektor Anda
   • REGION: nama region konektor Anda
   • MACHINE_TYPE: jenis mesin pilihan Anda. Untuk mempelajari tentang jenis mesin yang tersedia, baca dokumentasi tentang Throughput dan penskalaan.

Konsol

1. Buka halaman ringkasan Akses VPC Serverless.

   Buka Akses VPC Serverless

2. Pilih konektor yang ingin Anda edit, lalu klik Edit.

3. Di kolom Instance minimum, pilih jumlah minimum instance yang Anda inginkan.

   Nilai terkecil yang mungkin untuk kolom ini adalah nilai saat ini. Nilai terbesar yang mungkin untuk kolom ini adalah nilai saat ini di kolom Instance maksimum dikurangi 1. Misalnya, jika nilai di kolom Instance maksimum adalah 8, nilai terbesar yang mungkin untuk kolom Instance minimum adalah 7.

4. Di kolom Instance maksimum, pilih jumlah maksimum instance yang Anda inginkan.

   Nilai terkecil yang mungkin untuk kolom ini adalah nilai saat ini. Nilai terbesar yang mungkin untuk kolom ini adalah 10.

gcloud

1. Di konsol Google Cloud, aktifkan Cloud Shell.

   Aktifkan Cloud Shell

   Di bagian bawah Google Cloud Console, Cloud Shell sesi akan terbuka dan menampilkan perintah command line. Cloud Shell adalah lingkungan shell dengan Google Cloud CLI yang sudah terinstal, dan dengan nilai yang sudah ditetapkan untuk project Anda saat ini. Diperlukan waktu beberapa detik untuk melakukan inisialisasi sesi.

2. Untuk menambah jumlah minimum atau maksimum instance konektor, jalankan perintah berikut di terminal Anda:

   gcloud beta compute networks vpc-access connectors update CONNECTOR_NAME --region=REGION --min-instances=MIN_INSTANCES --max-instances=MAX_INSTANCES
   

   Ganti yang berikut:

• CONNECTOR_NAME: nama konektor Anda
• REGION: nama region konektor Anda
• MIN_INSTANCES: jumlah minimum instance yang Anda inginkan.
  • Nilai terkecil yang mungkin untuk kolom ini adalah nilai min_instances saat ini. Untuk mengetahui nilai saat ini, baca Menemukan nilai atribut saat ini.
  • Nilai terbesar yang mungkin untuk kolom ini adalah nilai max_instances saat ini dikurangi 1, karena min_instances harus lebih kecil dari max_instances. Misalnya, jika max_instances adalah 8, nilai terbesar yang mungkin untuk kolom ini adalah 7. Jika konektor Anda menggunakan nilai max-instances default 10, nilai terbesar yang mungkin untuk kolom ini adalah 9. Untuk mengetahui nilai max-instances, lihat Menemukan nilai atribut saat ini.

• MAX_INSTANCES:

  • Nilai terkecil yang mungkin untuk kolom ini adalah nilai max_instances saat ini. Untuk mengetahui nilai saat ini, baca Menemukan nilai atribut saat ini.
  • Nilai terbesar yang mungkin untuk kolom ini adalah 10.

  Jika hanya ingin menambah jumlah minimum instance, tetapi bukan jumlah maksimumnya, Anda tetap harus menentukan jumlah maksimum instance. Sebaliknya, jika Anda hanya ingin memperbarui jumlah maksimum instance, tetapi bukan jumlah minimumnya, Anda tetap harus menentukan jumlah minimum instance. Untuk mempertahankan jumlah minimum atau maksimum instance pada nilainya saat ini, tentukan nilai instance saat ini. Untuk mengetahui nilainya saat ini, baca Menemukan nilai atribut saat ini.

Konsol

1. Buka halaman ringkasan Akses VPC Serverless di konsol Google Cloud:

   Buka Akses VPC Serverless

2. Pilih konektor yang ingin dihapus.

3. Klik Delete.

gcloud

1. Di konsol Google Cloud, aktifkan Cloud Shell.

   Aktifkan Cloud Shell

   Di bagian bawah Google Cloud Console, Cloud Shell sesi akan terbuka dan menampilkan perintah command line. Cloud Shell adalah lingkungan shell dengan Google Cloud CLI yang sudah terinstal, dan dengan nilai yang sudah ditetapkan untuk project Anda saat ini. Diperlukan waktu beberapa detik untuk melakukan inisialisasi sesi.

2. Gunakan perintah gcloud berikut untuk menghapus konektor:

   gcloud compute networks vpc-access connectors delete CONNECTOR_NAME --region=REGION
   

   Ganti kode berikut:

   • CONNECTOR_NAME dengan nama konektor yang ingin dihapus
   • REGION dengan region tempat konektor berada

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 dan deploy revisi baru.

3. Jika Anda mengonfigurasi layanan baru, isi layanan awal setelan sesuai kebutuhan, lalu klik Container, volume, networking, security untuk luaskan 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 berada di jaringan VPC Anda, 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. Update komponen gcloud ke versi terbaru:

   gcloud components update
   

2. Pastikan Compute Engine API diaktifkan untuk project Anda:

   gcloud services enable compute.googleapis.com
   

3. 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. Subnet harus berukuran /26 atau lebih besar. Traffic keluar VPC langsung mendukung rentang IPv4 RFC 1918, RFC 6598, dan Class E. Anda dapat men-deploy atau menjalankan beberapa layanan atau tugas di subnet yang sama, tetapi subnet tersebut tidak dapat digunakan bersama oleh konektor yang ada.
   • 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.

4. 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 sudah 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. Subnet harus berukuran /26 atau lebih besar. Traffic keluar VPC langsung mendukung rentang IPv4 RFC 1918, RFC 6598, dan Class E. Anda dapat men-deploy atau menjalankan beberapa layanan atau tugas di subnet yang sama, tetapi subnet tersebut tidak dapat digunakan bersama oleh konektor yang ada.
   • 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 kode berikut ke file main.tf Anda:

   /**
    * 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 dan isi halaman pengaturan pekerjaan 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 berada di jaringan VPC Anda, klik tugas, 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. Update komponen gcloud ke versi terbaru:

   gcloud components update
   

2. Pastikan Compute Engine API diaktifkan untuk project Anda:

   gcloud services enable compute.googleapis.com
   

3. 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. Subnet harus berukuran /26 atau lebih besar. Traffic keluar VPC langsung mendukung rentang IPv4 RFC 1918, RFC 6598, dan Class E. Anda dapat men-deploy atau menjalankan beberapa layanan atau tugas di subnet yang sama, tetapi subnet tersebut tidak dapat digunakan bersama oleh konektor yang ada.
   • 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.

4. 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 mengupdate 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. Subnet harus berukuran /26 atau lebih besar. Traffic keluar VPC langsung mendukung rentang IPv4 RFC 1918, RFC 6598, dan Class E. Anda dapat men-deploy atau menjalankan beberapa layanan atau tugas di subnet yang sama, tetapi subnet tersebut tidak dapat digunakan bersama oleh konektor yang ada.
   • 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