Mencadangkan alamat IP internal statis
Halaman ini menunjukkan cara mencadangkan dan mengelola IPv4 atau IPv6 internal statis menggunakan alamat IP di jaringan Virtual Private Cloud (VPC).
Alamat IP internal statis memberikan kemampuan untuk mencadangkan alamat IP internal dari rentang alamat IP yang dikonfigurasikan di subnet, lalu menetapkan alamat IP internal yang dicadangkan tersebut ke resource sesuai kebutuhan. Mencadangkan alamat IP internal akan mengeluarkan alamat tersebut dari kumpulan alokasi dinamis dan mencegahnya digunakan untuk alokasi otomatis. Pencadangan alamat IP internal statis memerlukan izin Identity and Access Management (IAM) khusus, sehingga hanya pengguna berwenang yang dapat mencadangkan alamat IP internal statis.
Dengan kemampuan untuk mencadangkan alamat IP internal statis, Anda selalu dapat menggunakan alamat IP yang sama untuk resource yang sama meskipun harus menghapus dan membuat ulang resource.
Untuk mencadangkan alamat IP eksternal statis, bukan alamat IP internal, lihat Mencadangkan alamat IP eksternal statis.
Sebelum memulai
- Baca tentang alamat IP.
- Jika Anda belum melakukannya, siapkan autentikasi.
Autentikasi adalah proses di mana identitas Anda
telah diverifikasi untuk mendapatkan akses ke layanan dan API Google Cloud. Untuk menjalankan kode atau
contoh dari lingkungan pengembangan lokal, Anda dapat mengautentikasi sebagai berikut.
Pilih tab untuk melihat bagaimana Anda berencana menggunakan contoh di halaman ini:
Konsol
Saat menggunakan Konsol Google Cloud untuk mengakses API dan layanan Google Cloud, Anda tidak perlu menyiapkan autentikasi.
gcloud
Instal Google Cloud CLI, lalu initialize dengan menjalankan perintah berikut:
gcloud init
Terraform
Untuk menggunakan contoh Terraform di halaman ini dari lingkungan pengembangan lokal, instal dan lakukan inisialisasi gcloud CLI, lalu siapkan Kredensial Default Aplikasi dengan kredensial pengguna Anda.
- Menginstal Google Cloud CLI.
-
Untuk initialize gcloud CLI, jalankan perintah berikut:
gcloud init
-
Buat kredensial autentikasi lokal untuk Akun Google Anda:
gcloud auth application-default login
Untuk informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal dalam dokumentasi autentikasi Google Cloud.
REST
Untuk menggunakan contoh REST API di halaman ini dalam lingkungan pengembangan lokal, gunakan kredensial yang Anda berikan ke gcloud CLI.
Instal Google Cloud CLI, lalu initialize dengan menjalankan perintah berikut:
gcloud init
Peran yang diperlukan
Untuk mendapatkan izin yang diperlukan untuk
mencadangkan dan mengelola alamat IP statis,
minta administrator untuk memberi Anda
Peran IAM Compute Network Admin (roles/compute.networkAdmin
) di project Anda.
Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.
Peran bawaan ini berisi izin yang diperlukan untuk memesan dan mengelola alamat IP statis. Untuk melihat izin yang benar-benar diperlukan, luaskan bagian Izin yang diperlukan:
Izin yang diperlukan
Izin berikut diperlukan untuk mencadangkan dan mengelola alamat IP statis:
-
compute.addresses.create
-
compute.addresses.createInternal
-
compute.networks.list
-
compute.subnetworks.use
-
compute.subnetworks.list
Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.
Batasan
Anda tidak dapat membatalkan penetapan atau mengubah alamat IPv4 internal resource yang ada. Misalnya, Anda tidak dapat menetapkan alamat IP internal statis baru ke instance VM yang sedang berjalan atau instance VM yang dihentikan. Namun, Anda dapat mempromosikan alamat IP internal sementara dari sebuah resource menjadi alamat IP internal statis, sehingga alamat tersebut tetap dipertahankan bahkan setelah resource dihapus.
Jumlah alamat IP internal statis yang dapat dicadangkan tidak boleh melebihi kuota project Anda. Untuk mengetahui informasi lebih lanjut, lihat kuota per project dalam dokumentasi VPC.
Hanya satu resource dalam satu waktu yang dapat menggunakan alamat IP internal statis.
Pencadangan alamat IP internal statis hanya didukung untuk jaringan VPC. Layanan ini tidak didukung untuk jaringan mode lama.
Alamat IP internal statis tidak akan dilepas secara otomatis meski resource dihapus. Anda harus melepas alamat IP internal statis secara manual jika tidak lagi memerlukannya.
Anda tidak dapat mengubah nama alamat IP statis.
Alamat IP internal statis bersifat regional, artinya alamat tersebut dibatasi untuk di region tempat mereka dipesan. Misalnya, jika ada alamat IP internal statis yang dicadangkan di
Region A
, hanya dapat menggunakan alamat IP diRegion A
.
Mencadangkan alamat IPv4 atau IPv6 internal statis yang baru
Sebelum dapat mencadangkan alamat IP internal statis baru, Anda harus membuat jaringan VPC dengan subnet.
Jika Anda ingin mencadangkan alamat IPv6 internal statis yang baru, jaringan VPC harus mengaktifkan rentang IPv6 internal ULA.
Selain itu, alamat IP harus memiliki subnet dual-stack
dengan jenis akses IPv6 INTERNAL
.
Untuk mencadangkan alamat IP internal mandiri, selesaikan langkah-langkah berikut.
Konsol
- Di Konsol Google Cloud, buka halaman IP addresses.
- Klik Reserve internal static IP address. Anda mungkin perlu klik Menu Tindakan lainnya untuk melihat tombol ini.
- Di kolom Name, masukkan nama alamat IP.
- Dalam daftar Versi IP, pilih versi IP yang diperlukan:
- Untuk mencadangkan alamat IPv4 internal statis, pilih IPv4.
- Untuk mencadangkan alamat IPv6 internal statis, pilih IPv6.
- Dalam daftar Network and Subnetwork, pilih VPC jaringan dan subnet.
- Tentukan cara mencadangkan alamat IP:
- Untuk alamat IPv4, guna menentukan alamat IPv4 internal statis yang akan dicadangkan, untuk Alamat IP statis, pilih Izinkan saya memilih, lalu masukkan alamat IP kustom. Jika tidak, sistem akan otomatis menetapkan alamat IPv4 internal statis di subnet untuk Anda.
- Untuk alamat IPv6, sistem akan otomatis menetapkan alamat IPv6 internal statis dari rentang alamat IPv6 internal subnet.
Opsional: Jika Anda ingin berbagi alamat IPv4 internal statis di frontend yang berbeda, pada daftar Tujuan, pilih Shared. Pilihan defaultnya adalah Non-shared.
Klik Reserve.
gcloud
Untuk mencadangkan alamat IPv4 internal, gunakan perintah
compute addresses create
:gcloud compute addresses create ADDRESS_NAMES \ --region REGION --subnet SUBNETWORK \ --addresses IP_ADDRESS
Ganti kode berikut:
ADDRESS_NAMES
: nama satu atau beberapa alamat[--purpose=SHARED_LOADBALANCER_VIP]
yang ingin Anda buat. Jika terdapat beberapa alamat, tentukan semua alamat sebagai daftar, yang dipisahkan dengan spasi—misalnya,example-address-1 example-address-2 example-address-3
REGION
: wilayah untuk permintaan ini.SUBNETWORK
: subnet untuk alamat IP internal ini.IP_ADDRESS
: alamat IP yang akan dicadangkan, yang harus berada dalam rentang IP utama subnet. Jika tidak ditentukan, alamat IP akan otomatis dialokasikan dari subnet.
Untuk mencadangkan alamat IPv6 internal, gunakan perintah
compute addresses create
. TentukanIPV6
sebagai nilai untuk--ip-version
:gcloud compute addresses create ADDRESS_NAMES \ --region REGION --subnet SUBNETWORK \ --ip-version IPV6
Ganti kode berikut:
ADDRESS_NAMES
: nama satu atau beberapa alamat yang ingin Anda cadangkan. Jika terdapat beberapa alamat, tentukan semua alamat sebagai daftar, yang dipisahkan dengan spasi—misalnya,example-address-1 example-address-2 example-address-3
REGION
: region untuk permintaan ini.SUBNETWORK
: subnet untuk alamat IPv6 internal ini.
Tidak seperti pencadangan IPv4 internal, pencadangan IPv6 internal tidak mendukung pencadangan alamat IP tertentu dari subnetwork. Sebagai gantinya, alamat IPv6 internal
/96
akan otomatis dialokasikan dari rentang alamat IPv6 internal/64
subnet.
Contoh
Cadangkan alamat IPv4 internal yang dialokasikan secara otomatis dari subnet:
gcloud compute addresses create example-address-1 \ --region us-central1 \ --subnet subnet-1
Cadangkan alamat IPv4 internal tertentu dari subnet:
gcloud compute addresses create example-address-1 \ --region us-central1 \ --subnet subnet-1 \ --addresses 10.128.0.12
Cadangkan alamat IPv6 internal statis dari subnet:
gcloud compute addresses create example-address-1 \ --region us-central1 \ --subnet subnet-1 \ --ip-version IPV6
Buat beberapa alamat IPv4 dengan meneruskan lebih dari satu nama alamat IPv4; semua alamat tersebut dicadangkan dalam subnet yang sama:
gcloud compute addresses create example-address-1 example-address-2 \ --region us-central1 \ --subnet subnet-1 \ --addresses 10.128.0.12,10.128.0.13
Terraform
Anda dapat menggunakan modul Terraform untuk membuat alamat IP internal.
Pada contoh berikut, argumen Terraform memiliki nilai contoh yang dapat Anda ubah. Contoh ini akan membuat dua alamat IP internal tertentu:
Contoh berikut akan membuat dua alamat IP internal yang dialokasikan secara dinamis:
API
Gunakan
metode addresses.insert
:
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/addresses
Untuk alamat IPv4 dan IPv6, isi permintaan harus menyertakan kolom addressType
, yang harus berupa INTERNAL
, name
alamat, dan subnetwork
yang memiliki alamat IP tersebut. Isi permintaan
secara opsional dapat menyertakan purpose
alamat IP internal.
Selain itu, untuk alamat IPv4 internal, Anda dapat mengizinkan sistem
mengalokasikan alamat IP untuk Anda secara otomatis, atau menggunakan address
untuk menentukan
alamat IPv4 internal. Alamat IPv4 harus termasuk dalam rentang alamat IP utama subnet.
{ "addressType": "INTERNAL", "name": "IPV4_ADDRESS_NAME", "subnetwork": "regions/REGION/subnetworks/SUBNETWORK", "address": "IPV4_ADDRESS" "purpose": "GCE_ENDPOINT" }
Contoh:
POST https://compute.googleapis.com/compute/v1/projects/example-project/regions/us-central1/addresses { "addressType": "INTERNAL", "name": "example-ipv4-address-1", "subnetwork": "regions/us-central1/subnetworks/my-custom-subnet", "address": "10.128.0.12" "purpose": "GCE_ENDPOINT" }
Untuk alamat IPv6 internal, Anda juga harus menentukan ipVersion
sebagai IPV6
.
Sistem akan otomatis menetapkan alamat IPv6 internal statis dari
rentang alamat IPv6 internal subnet.
{ "addressType": "INTERNAL", "name": "IPV6_ADDRESS_NAME", "ipVersion": "IPV6", "subnetwork": "regions/REGION/subnetworks/SUBNETWORK", "purpose": "GCE_ENDPOINT" }
Contoh:
POST https://compute.googleapis.com/compute/v1/projects/example-project/regions/us-central1/addresses { "addressType": "INTERNAL", "name": "example-ipv6-address-1", "ipVersion": "IPV6" "subnetwork": "regions/us-central1/subnetworks/my-custom-subnet", "purpose": "GCE_ENDPOINT" }
Mencadangkan rentang alamat IP internal statis untuk VPN dengan ketersediaan tinggi (HA) melalui Cloud Interconnect
Anda dapat mencadangkan rentang alamat IP internal statis untuk digunakan dengan VPN dengan ketersediaan tinggi (HA) melalui Cloud Interconnect.
Saat membuat alamat IP internal statis, Anda harus menentukan flag --purpose=IPSEC_INTERCONNECT
dan panjang awalan (--prefix-length
) antara 26 hingga 29.
Alamat IPv4 internal regional yang Anda cadangkan diterapkan ke gateway VPN dengan ketersediaan tinggi (HA) yang digunakan oleh Cloud Interconnect.
Untuk mengetahui informasi selengkapnya, lihat Menetapkan rentang alamat IP internal ke gateway VPN dengan ketersediaan tinggi (HA).
Menentukan apakah alamat IPv4 atau IPv6 internal bersifat sementara atau statis
Alamat IP internal statis dan sementara berperilaku dan tampak sama dalam sebagian besar konteks. Namun, dengan alamat IP internal statis, Anda dapat menggunakan IP yang sama untuk resource yang sama meskipun Anda menghapus dan membuat ulang resource. Secara umum, alamat IP efemeral dirilis jika Anda menghentikan atau menghapus resource Anda
Untuk menentukan apakah alamat bersifat statis atau sementara, lakukan hal berikut:
Di Konsol Google Cloud, buka halaman IP addresses.
Temukan alamat dalam daftar dan periksa kolom Jenis untuk mengetahui jenis alamat IP.
Mempromosikan alamat IPv4 atau IPV6 internal sementara yang sedang digunakan menjadi alamat statis
Jika Anda memiliki alamat IP internal sementara yang sedang digunakan, Anda dapat mempromosikan alamat ini ke alamat IP internal statis sehingga alamat tersebut tetap dengan project sampai Anda menghapusnya secara aktif.
Untuk mempromosikan alamat IP internal sementara menjadi alamat IP internal statis, lakukan langkah-langkah berikut.
Konsol
- Di Konsol Google Cloud, buka halaman IP addresses.
- Klik Alamat IP internal.
- Opsional: Di kolom Filter, untuk menelusuri alamat IP sementara,
masukkan
ephemeral
lalu pilih Ephermal : Type dari menu drop-down daftar. - Pilih alamat IP internal yang ingin dipromosikan.
- Dalam menu Tindakan lainnya ( ) di akhir baris tampilan untuk alamat IP yang dipilih, pilih Promosikan ke alamat IP statis.
- Masukkan nama untuk alamat IP statis baru, lalu klik Cadangkan.
gcloud
Sebelum mempromosikan alamat IPv6 internal sementara yang sudah ada, Anda perlu mengetahui nilai alamat IP tersebut. Gunakan Google Cloud CLI untuk membuat permintaan
describe
ke resource guna mendapatkan nilai alamat IP.Untuk instance dengan alamat IPv4, gunakan perintah berikut:
gcloud compute instances describe INSTANCE_NAME --zone ZONE | grep "networkIP"
Untuk instance dengan alamat IPv6, gunakan perintah berikut:
gcloud compute instances describe INSTANCE_NAME --zone ZONE | grep "ipv6Address"
Untuk aturan penerusan regional, gunakan perintah berikut:
gcloud compute forwarding-rules describe FORWARDING_RULE_NAME --region REGION | grep "IPAddress"
Untuk aturan penerusan global, gunakan flag
--global
, bukan flag tanda--region
.
Mempromosikan alamat:
Untuk mempromosikan satu atau beberapa alamat IPv4 internal yang sudah ada, gunakan perintah
compute addresses create
dan berikan flag--addresses
dengan alamat IP internal eksplisit yang akan dipromosikan:gcloud compute addresses create IPV4_ADDRESS_NAMES \ --addresses IPV4_ADDRESSES \ --region REGION \ --prefix-length PREFIX_LENGTH \ --subnet SUBNETWORK
Ganti kode berikut:
IPV4_ADDRESS_NAMES
: nama alamat IPv4. Jika terdapat beberapa alamat, tentukan semua nama alamat sebagai daftar, yang dipisahkan dengan spasi—misalnya,example-address-name-1 example-address-name-2 example-address-name-3
. Deklarasikan nama dalam urutan yang sama seperti saat Anda mendeklarasikan alamat IP. Misalnya, Anda menentukan nama alamat sebagaiexample-address-name-1 example-address-name-2 example-address-name-3
dan alamat IPv4 sebagai192.0.2.0 192.0.2.1 192.0.2.2
. Dalam skenario ini, Compute Engine memetakan nama dan alamat dengan cara berikut:example-address-name-1
:192.0.2.0
example-address-name-2
:192.0.2.1
example-address-name-3
:192.0.2.2
IPV4_ADDRESSES
: alamat IPv4 yang akan dipromosikan. Jika terdapat beberapa alamat, tentukan semua alamat sebagai daftar, yang dipisahkan dengan spasi—misalnya,192.0.2.0 192.0.2.1 192.0.2.2
.REGION
: region untuk mencadangkan alamat ini.PREFIX_LENGTH
: Opsional. Panjang awalan rentang alamat IPv4. Nilai harus berupa bilangan bulat antara 7 dan 31. Sertakan kolom ini hanya jika Anda menentukan rentang alamat. Kecualikan kolom ini jika alamat IPv4 yang ditentukan merupakan alamat IP tunggal.SUBNETWORK
: subnetwork untuk permintaan ini.
Untuk mempromosikan satu atau beberapa alamat IPv6 internal yang sudah ada, gunakan Perintah
compute addresses create
dan berikan tanda--addresses
dengan alamat IPv6 internal eksplisit:gcloud compute addresses create IPV6_ADDRESS_NAMES \ --addresses IPV6_ADDRESSES \ --region REGION \ --prefix-length PREFIX_LENGTH \ --subnet SUBNETWORK
Ganti kode berikut:
IPV6_ADDRESS_NAMES
: nama alamat. Deklarasikan nama dalam urutan yang sama dengan Anda mendeklarasikan IPv6 untuk alamat internal dan eksternal. Dalam kasus ini,IPV6_ADDRESS_NAME_1
sesuai denganIPV6_ADDRESS_1
, danIPV6_ADDRESS_NAME_2
sesuai denganIPV6_ADDRESS_2
.IPV6_ADDRESS_1,[IPV6_ADDRESS_2,...]
: alamat IPv6 yang akan dipromosikan dalam format CIDR.PREFIX_LENGTH_1,[PREFIX_LENGTH_2,...]
: panjang awalan alamat IPv6.REGION
: region untuk mencadangkan alamat ini.SUBNETWORK
: subnetwork untuk permintaan ini.
Alamat IPv6 internal tetap terpasang pada instance yang ada bahkan setelah dipromosikan menjadi alamat IPv6 internal statis. Jika Anda perlu menetapkan alamat IPv6 internal statis yang baru dipromosikan ke resource lain, pertama-tama batalkan penetapan alamat IPv6 internal statis dari instance yang ada.
API
Gunakan
metode addresses.insert
:
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/addresses
Untuk alamat IPv4 dan IPv6, isi permintaan harus menyertakan
addressType
, yang harus berupa INTERNAL
, name
alamat, address
yang akan dipromosikan, dan subnetwork
tempat alamat IP tersebut berada.
Selain itu, isi permintaan harus menyertakan prefixLength
dengan 96
sebagai nilai untuk alamat IPv6.
Isi permintaan untuk mempromosikan alamat IPv4 internal:
{ "name": "ADDRESS_NAME", "addressType": "INTERNAL", "address": "IP_ADDRESS", "subnetwork": "regions/REGION/subnetworks/SUBNETWORK" }
Contoh:
POST https://compute.googleapis.com/compute/v1/projects/example-project/regions/us-central1/addresses { "name": "example-IPv4-address-1", "addressType": "INTERNAL", "address": "10.128.0.2", "subnetwork": "regions/us-central1/subnetworks/my-custom-subnet" }
Isi permintaan untuk mempromosikan alamat IPv6 internal:
{ "name": "ADDRESS_NAME", "addressType": "INTERNAL", "address": "IP_ADDRESS", "subnetwork": "regions/REGION/subnetworks/SUBNETWORK" "prefixLength": 96 }
Contoh:
POST https://compute.googleapis.com/compute/v1/projects/example-project/regions/us-central1/addresses { "name": "example-IPv6-address-1", "addressType": "INTERNAL", "address": "fd20:0:0::", "subnetwork": "regions/us-central1/subnetworks/my-custom-subnet" "prefixLength": 96 }
Menggunakan alamat IPv4 atau IPv6 internal statis dengan VPC Bersama
Anda dapat membuat alamat IP internal statis yang dicadangkan di subnet bersama dari jaringan VPC Bersama. Objek alamat IP itu sendiri dibuat dalam project layanan yang sama dengan resource yang akan menggunakannya, meskipun nilainya berasal dari rentang alamat IP yang tersedia dalam subnet bersama yang dipilih dari jaringan VPC Bersama. Untuk mengetahui informasi selengkapnya tentang kasus penggunaan ini, lihat referensi berikut:
- Bagian Alamat IP di ringkasan VPC Bersama
- Bagian Cadangkan alamat IPv4 atau IPv6 internal statis di Penyediaan VPC Bersama
Mencantumkan alamat IPv4 atau IPv6 internal statis
Untuk melihat semua alamat IP internal statis yang ada, selesaikan langkah-langkah berikut langkah.
Konsol
Di Konsol Google Cloud, buka halaman IP addresses.
Klik Alamat IP internal.
gcloud
Gunakan perintah gcloud compute addresses list
:
gcloud compute addresses list
API
Gunakan metode addresses.list
:
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/addresses
Ganti kode berikut:
PROJECT_ID
: project ID untuk permintaan iniREGION
: nama region untuk permintaan ini
Untuk menampilkan daftar semua alamat di semua region, gunakan metode addresses.aggregatedList
:
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/addresses
Melepas alamat IPv4 atau IPv6 internal statis
Jika tidak lagi memerlukan alamat IP internal statis, Anda dapat melepas alamat IP dengan menghapus resource alamat IP.
Jika menggunakan konsol Google Cloud, Anda dapat melepas alamat IP statis hanya jika tidak digunakan oleh resource lain.
Jika menggunakan gcloud CLI atau API, Anda dapat merilis alamat IP baik sedang digunakan oleh sumber daya lain atau tidak.
Jika alamat IP tidak digunakan oleh suatu resource, alamat IP tersebut akan dikembalikan ke kumpulan alamat IP internal yang tersedia.
Jika alamat IP digunakan oleh suatu resource, alamat IP tersebut akan tetap terpasang ke resource tersebut hingga resource dihapus.
Untuk melepas alamat IPv4 atau IPv6 internal statis, selesaikan langkah-langkah berikut.
Konsol
- Di Konsol Google Cloud, buka halaman IP addresses.
- Pilih tab Internal IP addresses.
- Opsional: Di kolom Filter, masukkan
static
, lalu pilih Static : Ketik dari menu drop-down. - Pilih alamat IP internal statis yang ingin dilepas.
Klik Lepaskan alamat statis, lalu konfirmasi operasi ini dengan mengklik Lepaskan dalam dialog.
Jika Anda tidak melihat opsi ini, klik menu Tindakan lainnya (
) di panel menu atas, lalu pilih Lepaskan alamat statis dari daftar.
gcloud
Gunakan
perintah compute addresses delete
:
gcloud compute addresses delete ADDRESS_NAME \ --region REGION
Ganti kode berikut:
ADDRESS_NAME
: nama alamat yang akan dihapus.REGION
: region tempat alamat berada.
Contoh:
gcloud compute addresses delete example-address-to-delete \ --region us-west1
API
Gunakan
metode addresses.delete
:
DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/addresses/ADDRESS_NAME
Contoh ini menghapus alamat di region us-west1
:
DELETE https://compute.googleapis.com/compute/v1/projects/myproject/regions/us-west1/addresses/example-address-to-delete
Langkah selanjutnya
- Pelajari cara mengonfigurasi alamat IP internal statis untuk VM.
Buat load balancer internal yang menggunakan alamat IPv4 internal statis:
Pelajari spesifikasi alamat IP tentang aturan penerusan, dan cara menggunakan aturan penerusan, di Ringkasan aturan penerusan.
Pelajari alamat IP lebih lanjut.