Halaman ini diterjemahkan oleh Cloud Translation API.

Membuat layanan pemetaan port

Halaman ini menjelaskan cara produsen layanan memublikasikan layanan yang menggunakan pemetaan port Private Service Connect.

Pemetaan port Private Service Connect memungkinkan klien konsumen berkomunikasi secara pribadi dengan port layanan tertentu di VM produsen tertentu melalui satu endpoint Private Service Connect.

Sebelum memulai

Anda harus mengaktifkan Compute Engine API di project Anda.
Anda harus membuat VM untuk setiap endpoint jaringan yang ingin dilampirkan ke NEG pemetaan port. Semua VM harus berada di region yang sama.
Baca Tentang layanan yang dipublikasikan.
Baca Tentang pemetaan port Private Service Connect.

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan guna menyiapkan publikasi layanan dengan pemetaan port Private Service Connect, minta administrator untuk memberi Anda peran IAM berikut pada project produsen:

Compute Load Balancer Admin (roles/compute.loadBalancerAdmin)
Compute Network Admin (roles/compute.networkAdmin)

Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Membuat dan memublikasikan layanan pemetaan port

Layanan pemetaan port memiliki konfigurasi yang mirip dengan Load Balancer Jaringan passthrough internal, tetapi traffic tidak diseimbangkan bebannya. Untuk membuat dan memublikasikan layanan pemetaan port, lakukan hal berikut:

Membuat NEG pemetaan port
Menambahkan endpoint jaringan ke NEG pemetaan port
Membuat layanan pemetaan port
Memublikasikan layanan pemetaan port

Membuat NEG pemetaan port

NEG jaringan pemetaan port adalah NEG regional dengan jenis endpoint jaringan GCE_VM_IP_PORTMAP. Anda tidak dapat mengubah jenis NEG pemetaan port setelah dibuat.

Saat membuat NEG pemetaan port, Anda memilih subnet. Endpoint jaringan yang Anda kaitkan dengan NEG pemetaan port harus memiliki antarmuka jaringan utama di subnet ini.

Konsol

Di konsol Google Cloud , buka halaman Network Endpoint Groups.

Buka Grup Endpoint Jaringan
Klik Create network endpoint group.
Masukkan Nama.
Klik Network endpoint group type, lalu pilih Port mapping NEG (Regional).
Pilih Region.
Pilih Network.
Pilih Subnetwork.
Klik Create.

gcloud

Gunakan perintah network-endpoints-groups create.

gcloud compute network-endpoint-groups create NEG \
    --region=REGION \
    --network=NETWORK \
    --subnet=SUBNET \
    --network-endpoint-type=GCE_VM_IP_PORTMAP

Ganti kode berikut:

NEG: nama NEG pemetaan port
REGION: region NEG pemetaan port
NETWORK: jaringan VPC dari NEG pemetaan port
SUBNET: subnet NEG pemetaan port

API

Kirim permintaan POST ke metode regionNetworkEndpointGroups.insert.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/networkEndpointGroups
{
  "name": "NEG",
  "networkEndpointType": "GCE_VM_IP_PORTMAP",
  "network": "projects/PROJECT_ID/global/networks/NETWORK",
  "subnetwork": "projects/PROJECT_ID/regions/REGION/subnetworks/SUBNET"
}

Ganti kode berikut:

PROJECT_ID: project ID dari pemetaan port NEG
REGION: region NEG pemetaan port
NEG: nama NEG pemetaan port
NETWORK: jaringan VPC dari NEG pemetaan port
SUBNET: subnet NEG pemetaan port

Menambahkan endpoint jaringan ke NEG pemetaan port

Buat satu atau beberapa endpoint jaringan dengan pemetaan port dan lampirkan ke NEG pemetaan port.

Endpoint jaringan untuk NEG pemetaan port bersifat zonal dan harus memenuhi persyaratan berikut:

Setiap endpoint jaringan mengacu pada VM Compute Engine yang memiliki antarmuka jaringan utama di subnet yang sama dengan NEG pemetaan port.
Setiap endpoint jaringan mengacu pada port tujuan klien yang unik.
Setiap endpoint jaringan harus merujuk ke kombinasi unik port layanan dan VM.

Konsol

Di konsol Google Cloud , buka halaman Network Endpoint Groups.

Buka Grup Endpoint Jaringan
Klik nama NEG pemetaan port yang ingin Anda perbarui.
Klik Tambahkan endpoint jaringan.
Klik VM instance, lalu pilih VM.
Klik VM port 1, lalu masukkan port layanan.
Klik Client port 1, lalu masukkan port tujuan klien.
Untuk setiap endpoint jaringan tambahan yang ingin ditambahkan, klik Add network endpoint, lalu masukkan detail endpoint jaringan.
Klik Create.

gcloud

Gunakan perintah network-endpoint-groups update. Sertakan tanda --add-endpoint untuk setiap endpoint jaringan yang ingin Anda lampirkan.

gcloud compute network-endpoint-groups update NEG \
    --region=REGION \
    --add-endpoint=client-destination-port=CLIENT_DESTINATION_PORT_1,instance=projects/PROJECT_ID/zones/ZONE_1/instances/VM_1_NAME,port=VM_1_PORT \
    --add-endpoint=client-destination-port=CLIENT_DESTINATION_PORT_2,instance=projects/PROJECT_ID/zones/ZONE_2/instances/VM_2_NAME,port=VM_2_PORT

Ganti kode berikut:

NEG: nama NEG pemetaan port
REGION: region NEG pemetaan port
CLIENT_DESTINATION_PORT_1: port tujuan klien dari endpoint jaringan pertama
PROJECT_ID: project ID project produsen
ZONE_1: zona endpoint jaringan pertama
VM_1_NAME: nama VM tujuan untuk endpoint jaringan pertama
VM_1_PORT: port layanan endpoint jaringan pertama
CLIENT_DESTINATION_PORT_2: port tujuan klien dari endpoint jaringan kedua
ZONE_2: zona endpoint jaringan kedua
VM_2_NAME: nama VM tujuan untuk endpoint jaringan kedua
VM_2_PORT: port layanan endpoint jaringan kedua

API

Kirim permintaan POST ke metode regionNetworkEndpointGroups.attachNetworkEndpoints.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/networkEndpointGroups/NEG/attachNetworkEndpoints
{
  "networkEndpoints": [
    {
      "clientDestinationPort":CLIENT_DESTINATION_PORT_1,
      "instance": "projects/PROJECT_ID/zones/ZONE_1/instances/VM_1_NAME",
      "port": SERVICE_PORT_1
    },
    {
      "clientDestinationPort": CLIENT_DESTINATION_PORT_2,
      "instance": "projects/PROJECT_ID/zones/ZONE_2/instances/VM_2_NAME",
      "port": SERVICE_PORT_2
    }
  ]
}

Ganti kode berikut:

PROJECT_ID: project ID project produsen
REGION: region NEG pemetaan port
NEG: nama NEG pemetaan port
CLIENT_DESTINATION_PORT_1: port tujuan klien dari endpoint jaringan pertama
ZONE_1: zona endpoint jaringan pertama
VM_1_NAME: nama VM tujuan untuk endpoint jaringan pertama
SERVICE_PORT_1: port layanan endpoint jaringan pertama
CLIENT_DESTINATION_PORT_2: port tujuan klien dari endpoint jaringan kedua
ZONE_2: zona endpoint jaringan kedua
VM_2_NAME: nama VM tujuan untuk endpoint jaringan kedua
SERVICE_PORT_2: port layanan endpoint jaringan kedua

Membuat layanan pemetaan port

Untuk membuat layanan pemetaan port, selesaikan langkah-langkah berikut.

Anda tidak dapat mengubah NEG pemetaan port yang terkait dengan layanan backend setelah menambahkan NEG. Namun, Anda dapat memperbarui endpoint jaringan NEG pemetaan port.

Anda tidak dapat memperbarui koneksi aturan penerusan setelah dibuat. Jika Anda perlu terhubung ke layanan backend yang berbeda, hapus aturan penerusan, lalu buat yang baru.

Konsol

Memulai konfigurasi

Di konsol Google Cloud , buka halaman Load balancing.

Buka Load balancing
Klik Create load balancer.
Untuk Type of load balancer, pilih Network Load Balancer (TCP/UDP/SSL), lalu klik Next.
Untuk Proxy or passthrough, pilih Passthrough load balancer, lalu klik Next.
Untuk Public facing or internal, pilih Internal, lalu klik Next.
Klik Konfigurasikan.

Konfigurasi dasar

Masukkan Nama load balancer.
Pilih Region.
Pilih Network.

Konfigurasi backend

Untuk Backend type, pilih Port mapping network endpoint group.
Pilih Port mapping network endpoint group.

Konfigurasi frontend

Klik Frontend configuration.
Opsional: Masukkan Nama.
Opsional: Masukkan Deskripsi..
Pilih Protokol.
Pilih Subnetwork.
Klik Done.
Klik Create.

gcloud

Untuk membuat layanan backend, gunakan perintah backend-services create.
```
gcloud compute backend-services create SERVICE \
    --load-balancing-scheme=internal \
    --region=REGION \
    --network=NETWORK
```
Ganti kode berikut:
- SERVICE: nama layanan backend
- REGION: region layanan backend
- NETWORK: jaringan VPC produsen layanan backend
Untuk menambahkan NEG pemetaan port ke layanan backend, gunakan perintah backend-services add-backend.

Anda tidak dapat menambahkan beberapa NEG pemetaan port ke satu layanan backend.
```
gcloud compute backend-services add-backend SERVICE \
    --network-endpoint-group=NEG \
    --network-endpoint-group-region=REGION
```
Ganti NEG dengan nama NEG pemetaan port.
Untuk membuat aturan penerusan bagi layanan pemetaan port, gunakan perintah forwarding-rules create.

Aturan penerusan harus dikonfigurasi untuk meneruskan traffic untuk semua port tujuan klien.
```
gcloud compute forwarding-rules create RULE \
    --load-balancing-scheme=INTERNAL \
    --ip-protocol=PROTOCOL \
    --network=NETWORK \
    --subnet=SUBNET \
    --address=IP_ADDRESS \
    --ports=ALL \
    --region=REGION \
    --backend-service=SERVICE
```
Ganti kode berikut:
- RULE: nama aturan penerusan
- PROTOCOL: protokol aturan penerusan, yang dapat berupa TCP atau UDP
- SUBNET: subnet produsen, yang harus merupakan subnet yang sama dengan yang terkait dengan NEG pemetaan port
- IP_ADDRESS: alamat IP aturan penerusan, yang harus berasal dari rentang alamat IP subnet produsen

API

Untuk membuat layanan backend, kirim permintaan POST ke metode regionBackendServices.insert.
```
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/backendServices
{
  "name": "SERVICE",
  "loadBalancingScheme": "INTERNAL",
  "network": "projects/PROJECT_ID/global/networks/NETWORK"
}
```
Ganti kode berikut:
- PROJECT_ID: ID project layanan backend
- REGION: region layanan backend
- SERVICE: nama layanan backend
- NETWORK: jaringan VPC produsen

Untuk menambahkan NEG pemetaan port ke layanan backend, kirim permintaan PATCH ke metode regionBackendServices.patch.

Anda tidak dapat menambahkan beberapa NEG pemetaan port ke satu layanan backend.

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/backendServices/SERVICE
{
  "backends": [
    {
      "group": "https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/networkEndpointGroups/NEG"
    }
  ]
}

Ganti NEG dengan nama NEG pemetaan port Anda.

Untuk membuat aturan penerusan bagi layanan pemetaan port, kirim permintaan POST ke metode forwardingRules.insert.

Aturan penerusan harus dikonfigurasi untuk meneruskan traffic untuk semua port tujuan klien.
```
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID>/regions/REGION/forwardingRules
{
  "name": "RULE",
  "loadBalancingScheme": "INTERNAL",
  "IPProtocol": "PROTOCOL",
  "network": "projects/PROJECT_ID/global/networks/NETWORK",
  "subnetwork": "projects/PROJECT_ID/regions/REGION/subnetworks/SUBNET",
  "IPAddress": "IP_ADDRESS",
  "allPorts": true,
  "backendService": "projects/PROJECT_ID/regions/REGION/backendServices/SERVICE"
}
```
Ganti kode berikut:
- RULE: nama aturan penerusan
- PROTOCOL: protokol aturan penerusan, yang dapat berupa TCP atau UDP
- SUBNET: subnet produsen, yang harus merupakan subnet yang sama dengan yang terkait dengan NEG pemetaan port
- IP_ADDRESS: alamat IP aturan penerusan, yang harus berasal dari rentang alamat IP subnet produsen

Memublikasikan layanan pemetaan port

Agar layanan pemetaan port tersedia bagi konsumen, publikasikan layanan dengan membuat lampiran layanan. Saat membuat lampiran layanan, tentukan aturan penerusan yang terkait dengan layanan pemetaan port Anda.

Langkah selanjutnya

Memperbarui layanan pemetaan port