Membuat dan memperbarui Endpoint Keluar

Pratinjau

Produk atau fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum di Persyaratan Khusus Layanan. Produk dan fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Halaman ini menjelaskan cara membuat, memperbarui, dan mengaitkan Endpoint Keluar dengan zona penerusan dan kebijakan server DNS untuk mengaktifkan penerusan langsung kueri DNS menggunakan alamat IP pribadi dari jaringan VPC Anda. Dengan menggunakan pendekatan ini, Anda mendapatkan kontrol yang lebih terperinci atas traffic keluar. Untuk mengetahui informasi selengkapnya tentang Endpoint Keluar, lihat Ringkasan Endpoint Keluar.

Sebelum memulai

Izin yang diperlukan untuk langkah ini

Untuk menjalankan tugas ini, Anda harus diberi izin berikut atau peran IAM berikut.

Izin

• dns.outboundEndpoints.get
• dns.outboundEndpoints.list
• dns.outboundEndpoints.create
• dns.outboundEndpoints.update
• dns.outboundEndpoints.delete
• dns.outboundEndpoints.bindPrivateDNSZone
• dns.outboundEndpoints.bindPrivateDNSPolicy
• compute.networks.get
• compute.subnetworks.get
• compute.subnetworks.use

Peran

• roles/compute.networkAdmin
• roles/dns.admin

1. Di konsol Google Cloud , pada halaman pemilih project, pilih atau buat project Google Cloud .

   Peran yang diperlukan untuk memilih atau membuat project

   • Memilih project: Memilih project tidak memerlukan peran IAM tertentu—Anda dapat memilih project apa pun yang perannya telah diberikan kepada Anda.
   • Membuat project: Untuk membuat project, Anda memerlukan peran Project Creator (roles/resourcemanager.projectCreator), yang berisi izin resourcemanager.projects.create. Pelajari cara memberikan peran.
   Catatan: Jika tidak berencana untuk menyimpan resource yang Anda buat dalam prosedur ini, buatlah project, bukan memilih project yang ada. Setelah menyelesaikan langkah ini, Anda dapat menghapus project, yang akan menghapus semua resource yang terkait dengan project ini.

   Buka pemilih project

2. Verifikasi bahwa penagihan diaktifkan untuk project Google Cloud Anda.

3. Aktifkan Cloud DNS API, Compute Engine API, dan Network Services API, jika ada yang belum diaktifkan.

   Peran yang diperlukan untuk mengaktifkan API

   Untuk mengaktifkan API, Anda memerlukan izin serviceusage.services.enable. Jika Anda membuat project, kemungkinan Anda sudah memiliki izin ini melalui peran Pemilik (roles/owner). Jika tidak, Anda bisa mendapatkan izin ini melalui peran Service Usage Admin (roles/serviceusage.serviceUsageAdmin). Pelajari cara memberikan peran.

   Aktifkan API

Pastikan Anda memiliki jaringan VPC dengan konektivitas ke server nama DNS lokal atau eksternal. Di setiap region tempat Anda berencana men-deploy Endpoint Keluar, jaringan VPC Anda harus memiliki subnet reguler dan khusus proxy di region target. Untuk mengetahui informasi selengkapnya, lihat Membuat dan mengelola jaringan VPC.

Pastikan juga jaringan lokal Anda memiliki rute kembali untuk rentang alamat IP subnet khusus proxy regional dan konfigurasikan aturan firewall lokal untuk mengizinkan kueri DNS masuk (UDP dan TCP port 53) dari rentang alamat IP subnet khusus proxy regional.

Membuat Endpoint Keluar

Untuk membuat Endpoint Keluar, lakukan hal berikut:

Konsol

1. Di konsol Google Cloud , buka halaman Cloud DNS.

   Buka Cloud DNS

2. Buka tab Outbound endpoints, lalu klik Create outbound endpoint.

3. Di kolom Name, masukkan nama unik untuk endpoint.

4. (Opsional) Untuk kolom Description, masukkan deskripsi untuk endpoint.

5. Untuk Region, pilih region target.

6. Dalam daftar Network, pilih jaringan VPC Anda.

7. Untuk Subnet, pilih subnet reguler di region yang dipilih.

8. Untuk Alamat IP endpoint, masukkan string alamat IPv4 yang valid dari rentang subnet yang dipilih.

   Catatan: Alamat IP endpoint yang digunakan untuk menempatkan Endpoint Keluar di stack jaringan tidak digunakan untuk traffic keluar kueri DNS. Kueri DNS keluar hanya keluar dari rentang alamat IP subnet khusus proxy.

9. Untuk Proxy-only subnet, Konsol akan otomatis mendeteksi subnet khusus proxy regional di jaringan dan region VPC yang dipilih untuk keluar kueri keluar. Jika subnet khusus proxy tidak terdeteksi, klik Reserve subnet untuk membuatnya sebelum melanjutkan.

10. Klik Create.

gcloud

Jalankan perintah gcloud beta dns outbound-endpoints create:

gcloud beta dns outbound-endpoints create ENDPOINT_NAME \
    --project=PROJECT_ID \
    --network=VPC_NETWORK \
    --subnetwork=REGULAR_SUBNET \
    --location=REGION \
    --endpoint-ip=IP_ADDRESS \
    --description=DESCRIPTION

Ganti kode berikut:

• ENDPOINT_NAME: nama Endpoint Keluar
• PROJECT_ID: project ID Anda
• VPC_NETWORK: Jaringan VPC yang terkait dengan Endpoint Keluar, misalnya, projects/PROJECT_ID/global/networks/NETWORK_NAME atau hanya NETWORK_NAME
• REGULAR_SUBNET: subnet reguler yang menjadi sumber alokasi alamat IP pendengar internal endpoint, misalnya, projects/PROJECT_ID/regions/REGION/subnetworks/SUBNET_NAME atau hanya SUBNET_NAME
• REGION: region tempat endpoint di-deploy
• IP_ADDRESS: alamat IPv4 internal yang tersedia dari rentang alamat IP utama subnet reguler
• DESCRIPTION: deskripsi opsional untuk endpoint

API

Jalankan metode outboundEndpoints.create:

POST https://dns.googleapis.com/dns/v1beta2/projects/PROJECT_ID/locations/REGION/outboundEndpoints?outboundEndpointId=ENDPOINT_NAME
{
    "network": "projects/PROJECT_ID/global/networks/VPC_NETWORK",
    "subnetwork": "projects/PROJECT_ID/regions/REGION/subnetworks/REGULAR_SUBNET",
    "endpointIp": "IP_ADDRESS",
    "description": "DESCRIPTION"
}

Ganti kode berikut:

• PROJECT_ID: project ID Anda
• REGION: region tempat endpoint di-deploy
• ENDPOINT_NAME: nama Endpoint Keluar
• VPC_NETWORK: Jaringan VPC yang terkait dengan Endpoint Keluar
• REGULAR_SUBNET: subnet reguler yang menjadi sumber alokasi alamat IP pendengar internal endpoint
• IP_ADDRESS: alamat IPv4 internal yang tersedia dari rentang IP utama subnet reguler
• DESCRIPTION: deskripsi opsional untuk endpoint

Memperbarui Endpoint Keluar

Untuk memperbarui Endpoint Keluar, ikuti langkah-langkah berikut:

Konsol

1. Di konsol Google Cloud , buka halaman Cloud DNS.

   Buka Cloud DNS

2. Buka tab Outbound endpoints, lalu klik nama Endpoint Keluar yang ingin Anda perbarui.

3. Klik Edit, perbarui kolom Deskripsi, lalu klik Simpan.

gcloud

Jalankan perintah gcloud beta dns outbound-endpoints update:

gcloud beta dns outbound-endpoints update ENDPOINT_NAME \
    --project=PROJECT_ID \
    --location=REGION \
    --description=UPDATED_DESCRIPTION

Ganti kode berikut:

• ENDPOINT_NAME: nama Endpoint Keluar yang akan diupdate
• PROJECT_ID: project ID Anda
• REGION: region tempat endpoint di-deploy
• UPDATED_DESCRIPTION: deskripsi opsional yang diperbarui untuk endpoint

Catatan: Kolom region, project, jaringan, subnet, dan --endpoint-ip tidak dapat diubah pada endpoint yang ada. Anda harus menghapus endpoint yang ada dan membuat endpoint baru untuk mengubah nilai ini.

API

Jalankan metode outboundEndpoints.patch:

PATCH https://dns.googleapis.com/dns/v1beta2/projects/PROJECT_ID/locations/REGION/outboundEndpoints/ENDPOINT_NAME?updateMask=description
{
    "description": "UPDATED_DESCRIPTION"
}

Ganti kode berikut:

• PROJECT_ID: project ID Anda
• REGION: region tempat endpoint di-deploy
• ENDPOINT_NAME: nama Endpoint Keluar yang akan diupdate
• UPDATED_DESCRIPTION: deskripsi yang diperbarui untuk Endpoint Keluar

Catatan: Metode PATCH hanya mendukung pembaruan deskripsi Endpoint Keluar. Untuk mengubah region, jaringan, subnet, atau alamat IP endpoint, Anda harus menghapus endpoint yang ada dan membuat yang baru.

Mengaitkan endpoint dengan zona penerusan

Konsol

1. Di konsol Google Cloud , buka halaman Cloud DNS.

   Buka Cloud DNS

2. Buka tab Zones dan klik Create zone, atau pilih zona penerusan yang ada dan klik Edit.

3. Konfigurasikan parameter zona:

   1. Untuk Zone type, pilih Private.
   2. Untuk Zone name, masukkan ID unik untuk zona.
   3. Untuk DNS name, masukkan akhiran domain yang ingin Anda teruskan. Contoh, corp.example.com.
   4. (Opsional) Untuk Deskripsi, masukkan deskripsi.
   5. Untuk Options, pilih Forward queries to another server.
   6. Untuk Networks, pilih jaringan VPC yang diizinkan untuk menyelesaikan kueri terhadap zona ini.

4. Di bagian Destination DNS servers, masukkan alamat IPv4 atau FQDN target server nama eksternal/lokal Anda.

5. Untuk jalur penerusan, pilih Outbound Endpoints.

6. Di bagian Outbound Endpoints, pilih satu atau beberapa endpoint untuk menangani penerusan kueri:

   • Pilihan minimum: pilih setidaknya satu Endpoint Keluar (wajib diisi jika Endpoint Keluar dipilih sebagai jalur penerusan).
   • Batasan VPC tunggal: semua endpoint yang dipilih harus berada dalam jaringan VPC yang sama.
   • Praktik terbaik ketersediaan tinggi (HA): untuk pemulihan dari bencana antar-region dan failover otomatis, konfigurasikan dan pilih setidaknya dua endpoint di region yang berbeda dalam jaringan VPC tersebut.

7. Klik Buat (atau Simpan untuk zona yang ada).

gcloud

Kaitkan endpoint dengan zona penerusan menggunakan perintah gcloud beta dns managed-zones update:

gcloud beta dns managed-zones update ZONE_NAME \
    --project=PROJECT_ID \
    --outbound-endpoints=projects/PROJECT_ID/locations/REGION_1/outboundEndpoints/ENDPOINT_NAME_1,projects/PROJECT_ID/locations/REGION_2/outboundEndpoints/ENDPOINT_NAME_2

Ganti kode berikut:

• ZONE_NAME: nama zona penerusan yang akan diupdate
• PROJECT_ID: project ID Anda
• REGION_1 dan REGION_2: wilayah tempat endpoint di-deploy
• ENDPOINT_NAME_1: nama endpoint pertama yang akan dikaitkan dengan zona penerusan
• ENDPOINT_NAME_2: nama endpoint kedua yang akan dikaitkan dengan zona penerusan

API

Jalankan metode managedZones.patch:

PATCH https://dns.googleapis.com/dns/v1beta2/projects/PROJECT_ID/managedZones/ZONE_NAME
{
    "name": "ZONE_NAME",
    "dnsName": "DNS_NAME",
    "description": "DESCRIPTION",
    "visibility": "private",
    "forwardingConfig": {
        "outboundEndpoints": [
              {
                 "name": "projects/PROJECT_ID/locations/REGION_1/outboundEndpoints/ENDPOINT_NAME_1"
              },
              {
                 "name": "projects/PROJECT_ID/locations/REGION_2/outboundEndpoints/ENDPOINT_NAME_2"
              }
        ]
    }
}

Ganti kode berikut:

• PROJECT_ID: project ID Anda
• ZONE_NAME: nama zona penerusan yang akan diupdate
• DNS_NAME: Nama DNS untuk zona penerusan
• DESCRIPTION: (opsional) deskripsi zona penerusan yang diperbarui
• REGION_1 dan REGION_2: region tempat endpoint di-deploy (semua Endpoint Keluar yang tercantum di forwardingConfig harus termasuk dalam jaringan VPC yang sama)
• ENDPOINT_NAME_1: nama endpoint pertama yang akan dikaitkan dengan zona penerusan
• ENDPOINT_NAME_2: nama endpoint kedua yang akan dikaitkan dengan zona penerusan

Mengaitkan endpoint dengan kebijakan server DNS

Konsol

1. Di konsol Google Cloud , buka halaman Cloud DNS.

   Buka Cloud DNS

2. Buka tab DNS server policies, lalu klik Create Policy (atau pilih kebijakan server DNS yang ada, lalu klik Edit).

3. Konfigurasi hal berikut ini:

   1. Untuk Policy name, masukkan nama unik untuk kebijakan server.
   2. (Opsional) Untuk Description, masukkan deskripsi.
   3. Untuk Inbound query forwarding, tentukan apakah klien eksternal akan mengkueri workload VPC menggunakan endpoint masuk.
   4. Untuk DNS64, aktifkan atau nonaktifkan sintesis IPv6 sesuai kebutuhan.
   5. Untuk Log, aktifkan atau nonaktifkan logging DNS sesuai kebutuhan.
   6. Untuk VPC networks, pilih jaringan VPC yang akan menerapkan kebijakan server.

4. Di bagian Alternative DNS servers, masukkan alamat IPv4 target server nama eksternal atau lokal Anda.

5. Untuk jalur penerusan, pilih Outbound Endpoints.

6. Di bagian Outbound Endpoints, pilih satu atau beberapa endpoint untuk merutekan semua kueri VPC non-pribadi:

   • Pilihan minimum: pilih setidaknya satu Endpoint Keluar.
   • Batasan VPC tunggal: semua endpoint yang dipilih harus berasal dari jaringan VPC yang sama.
   • Praktik terbaik ketersediaan tinggi (HA): untuk pemulihan dari bencana antar-region dan failover otomatis, konfigurasikan dan pilih setidaknya dua endpoint di region yang berbeda dalam jaringan VPC tersebut.

7. Klik Buat (atau Simpan untuk kebijakan yang sudah ada).

gcloud

Kaitkan endpoint dengan kebijakan server DNS menggunakan perintah gcloud beta dns policies update:

gcloud beta dns policies update POLICY_NAME \
    --project=PROJECT_ID \
    --outbound-endpoints=projects/PROJECT_ID/locations/REGION_1/outboundEndpoints/ENDPOINT_NAME_1,projects/PROJECT_ID/locations/REGION_2/outboundEndpoints/ENDPOINT_NAME_2

Ganti kode berikut:

• POLICY_NAME: nama kebijakan server DNS yang akan diupdate
• PROJECT_ID: project ID Anda
• REGION_1 dan REGION_2: region tempat endpoint di-deploy
• ENDPOINT_NAME_1: nama endpoint pertama yang akan dikaitkan dengan kebijakan server DNS
• ENDPOINT_NAME_2: nama endpoint kedua yang akan dikaitkan dengan kebijakan server DNS

API

Jalankan metode policies.patch:

PATCH https://dns.googleapis.com/dns/v1beta2/projects/PROJECT_ID/policies/POLICY_NAME
{
    "alternativeNameServerConfig": {
        "outboundEndpoints": [
            {"name": "projects/PROJECT_ID/locations/REGION_1/outboundEndpoints/ENDPOINT_NAME_1"},
            {"name": "projects/PROJECT_ID/locations/REGION_2/outboundEndpoints/ENDPOINT_NAME_2"}
        ]
    }
}

Ganti kode berikut:

• PROJECT_ID: project ID Anda
• POLICY_NAME: nama kebijakan server DNS yang akan diupdate
• REGION_1 dan REGION_2: region tempat endpoint di-deploy
• ENDPOINT_NAME_1: nama endpoint pertama yang akan dikaitkan dengan kebijakan server DNS
• ENDPOINT_NAME_2: nama endpoint kedua yang akan dikaitkan dengan kebijakan server DNS

Melihat Endpoint Keluar

Untuk mencantumkan atau mendeskripsikan Endpoint Keluar di suatu region, ikuti langkah-langkah berikut:

Konsol

1. Di konsol Google Cloud , buka halaman Cloud DNS.

   Buka Cloud DNS

2. Buka tab Outbound endpoints untuk melihat semua Endpoint Keluar di project Anda, region, jaringan, subnet, alamat IP, dan status responsnya.

gcloud

Untuk mencantumkan semua Endpoint Keluar di suatu region, jalankan perintah gcloud beta dns outbound-endpoints list:

gcloud beta dns outbound-endpoints list \
    --project=PROJECT_ID \
    --location=REGION

Ganti kode berikut:

• PROJECT_ID: project ID Anda
• REGION: region tempat endpoint di-deploy

Untuk melihat detail Endpoint Keluar tertentu, jalankan perintah gcloud beta dns outbound-endpoints describe:

gcloud beta dns outbound-endpoints describe ENDPOINT_NAME \
    --project=PROJECT_ID \
    --location=REGION

Ganti kode berikut:

• ENDPOINT_NAME: nama Endpoint Keluar
• PROJECT_ID: project ID Anda
• REGION: region tempat endpoint di-deploy

API

Untuk mencantumkan semua Endpoint Keluar di suatu region, kirim permintaan GET:

GET https://dns.googleapis.com/dns/v1beta2/projects/PROJECT_ID/locations/REGION/outboundEndpoints

Ganti kode berikut:

• PROJECT_ID: project ID Anda
• REGION: region tempat endpoint di-deploy

Untuk melihat detail Endpoint Keluar tertentu, kirim permintaan GET:

GET https://dns.googleapis.com/dns/v1beta2/projects/PROJECT_ID/locations/REGION/outboundEndpoints/ENDPOINT_NAME

Ganti kode berikut:

• PROJECT_ID: project ID Anda
• REGION: region tempat endpoint di-deploy
• ENDPOINT_NAME: nama Endpoint Keluar

Menghapus Endpoint Keluar

Sebelum dapat menghapus Endpoint Keluar, Anda harus membatalkan pengaitannya dari zona penerusan atau kebijakan server DNS yang mereferensikannya. Untuk mengetahui informasi selengkapnya, lihat Mengelola resource jaringan yang terkait dengan Endpoint Keluar.

Setelah membatalkan pengaitan Endpoint Keluar dari semua zona penerusan dan kebijakan server DNS, ikuti langkah-langkah berikut untuk menghapus endpoint:

Konsol

1. Di konsol Google Cloud , buka halaman Cloud DNS.

   Buka Cloud DNS

2. Buka tab Outbound endpoints.

3. Pilih Endpoint Keluar yang ingin Anda hapus, lalu klik Delete.

gcloud

Jalankan perintah gcloud beta dns outbound-endpoints delete:

gcloud beta dns outbound-endpoints delete ENDPOINT_NAME \
    --project=PROJECT_ID \
    --location=REGION

Ganti kode berikut:

• ENDPOINT_NAME: nama Endpoint Keluar yang akan dihapus
• PROJECT_ID: project ID Anda
• REGION: region tempat endpoint di-deploy

API

Gunakan metode outboundEndpoints.delete:

DELETE https://dns.googleapis.com/dns/v1beta2/projects/PROJECT_ID/locations/REGION/outboundEndpoints/ENDPOINT_NAME

Ganti kode berikut:

• PROJECT_ID: project ID Anda
• REGION: region tempat endpoint di-deploy
• ENDPOINT_NAME: nama Endpoint Keluar yang akan dihapus

Memecahkan masalah

Untuk menemukan metode dalam mendiagnosis dan menyelesaikan error terkait Endpoint Keluar, lihat Pemecahan masalah.

Langkah berikutnya

• Pelajari lebih lanjut Endpoint Keluar.