Menambahkan Dynamic Network Interface ke instance

Halaman ini menjelaskan cara menambahkan Antarmuka Jaringan Dinamis (NIC) ke instance Compute Engine yang ada.

Untuk mengetahui informasi tentang cara membuat instance baru, lihat Membuat VM dengan beberapa antarmuka jaringan.

Sebelum memulai

Sebelum menambahkan NIC Dinamis ke instance, lakukan hal berikut:

Menambahkan NIC Dinamis

Bagian berikut menjelaskan cara menambahkan NIC Dinamis ke instance individual atau instance yang merupakan bagian dari grup instance terkelola (MIG).

Saat menambahkan NIC Dinamis, Anda mungkin mengamati penundaan propagasi. Penundaan ini biasanya berlangsung selama beberapa detik, tetapi terkadang juga dapat berlangsung hingga satu menit.

Menambahkan NIC Dinamis ke instance

Bagian ini menjelaskan cara menambahkan NIC Dinamis ke instance.

Konsol

  1. Di konsol Google Cloud , buka halaman VM instances.

    Buka instance VM

  2. Klik nama instance yang ingin Anda tambahi NIC Dinamis.

  3. Di halaman detail instance, klik Edit.

  4. Di bagian Dynamic Network Interfaces, klik Add a Dynamic Network Interface dan lakukan hal berikut:

    1. Di kolom Interface type, pilih VPC.

    2. Di kolom Parent network interface, pilih vNIC induk untuk membuat NIC Dinamis.

    3. Di kolom VLAN ID, masukkan VLAN ID NIC Dinamis.

    4. Untuk Network dan Subnetwork, pilih jaringan dan subnetwork yang ingin digunakan.

    5. Pilih salah satu opsi berikut untuk jenis stack IP untuk NIC Dinamis:

      • IPv4 (single-stack)
      • IPv4 dan IPv6 (stack ganda)
      • IPv6 (single-stack)

    6. Untuk NIC Dinamis dengan alamat IPv4, lakukan hal berikut:

      1. Untuk Primary internal IPv4, pilih salah satu opsi berikut:

        • Ephemeral (Automatic) untuk menetapkan alamat IPv4 efemeral baru secara otomatis
        • Ephemeral (Custom) untuk menentukan alamat IPv4 efemeral baru secara manual
        • Alamat IPv4 internal statis yang dicadangkan dari daftar
        • Reserve static internal IPv4 address untuk mencadangkan dan menetapkan alamat IPv4 internal statis yang baru

      2. Untuk External IPv4 address, pilih salah satu opsi berikut:

        • Ephemeral untuk menetapkan alamat IPv4 efemeral baru
        • None untuk tidak menetapkan alamat IPv4 eksternal
        • Alamat IPv4 yang dicadangkan dari daftar
        • Reserve static external IP address untuk mencadangkan dan menetapkan alamat IPv4 eksternal statis yang baru

      3. Secara opsional, Anda dapat menetapkan satu atau beberapa rentang IP alias ke antarmuka jaringan. Untuk menetapkan rentang IP alias, lakukan hal berikut:

        1. Di Rentang IP alias, klik Tambahkan rentang IP.
        2. Di Rentang subnet, pilih rentang alamat IPv4 primer subnet atau rentang alamat IPv4 sekunder subnet yang akan digunakan.
        3. Untuk Rentang IP alias, masukkan rentang IP dalam notasi CIDR. Rentang ini harus merupakan rentang yang tidak digunakan dari rentang IP subnet yang Anda pilih.

        Untuk mengetahui informasi selengkapnya tentang cara menetapkan rentang IP alias ke antarmuka jaringan VM, lihat Mengonfigurasi rentang IP alias.

    7. Untuk NIC Dinamis dengan alamat IPv6, konfigurasi rentang alamat IPv6 internal atau eksternal, bergantung pada jenis akses subnet yang terhubung. Untuk Primary internal IPv6 address atau External IPv6 address, pilih dari opsi berikut:

      • Ephemeral (Automatic) untuk menetapkan rentang alamat IPv6 efemeral baru secara otomatis
      • Ephemeral (Custom) untuk menentukan rentang alamat IPv6 efemeral baru secara manual
      • Rentang alamat IPv6 statis yang dicadangkan dari daftar
      • Reserve static internal IPv6 address atau Reserve static external IPv6 address untuk mencadangkan dan menetapkan rentang alamat IPv6 statis yang baru

    8. Untuk menyelesaikan pengeditan properti NIC Dinamis, klik Selesai.

  5. Untuk menyimpan konfigurasi, klik Simpan.

gcloud

Untuk menambahkan NIC Dinamis ke instance yang ada, gunakan perintah gcloud compute instances network-interfaces add.

gcloud compute instances network-interfaces add INSTANCE_NAME \
   --zone=ZONE \
   --vlan=VLAN_ID \
   --parent-nic-name=PARENT_VNIC_NAME \
   --network=NETWORK \
   --subnetwork=SUBNET

Ganti kode berikut:

  • INSTANCE_NAME: nama instance untuk menambahkan NIC Dinamis
  • ZONE: zona instance
  • VLAN_ID: ID VLAN Dynamic NIC
  • PARENT_VNIC_NAME: nama vNIC induk, seperti nic0
  • NETWORK: jaringan tempat NIC Dinamis terpasang
  • SUBNET: subnet tempat NIC Dinamis terpasang

Atau, Anda dapat menambahkan NIC Dinamis ke instance saat memperbarui properti instance. Untuk mengetahui informasi selengkapnya, lihat Memperbarui properti instance.

API

Untuk menambahkan NIC Dinamis ke instance yang ada, gunakan metode instances.addNetworkInterface.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/addNetworkInterface
{
  "subnetwork": "regions/REGION/subnetworks/SUBNET",
  "parentNicName": "PARENT_VNIC_NAME",
  "vlan": "VLAN_ID"
}

Ganti kode berikut:

  • PROJECT_ID: ID project yang berisi instance
  • ZONE: zona yang berisi instance
  • INSTANCE_NAME: nama instance untuk menambahkan NIC Dinamis
  • REGION: region yang berisi instance
  • SUBNET: subnet tempat NIC Dinamis terpasang
  • PARENT_VNIC_NAME: nama vNIC induk, seperti nic0
  • VLAN_ID: ID VLAN NIC Dinamis

Atau, Anda dapat menambahkan NIC Dinamis ke instance saat memperbarui properti instance. Untuk mengetahui informasi selengkapnya, lihat Memperbarui properti instance.

Menambahkan NIC Dinamis ke instance di MIG

Bagian ini menjelaskan cara menambahkan NIC Dinamis ke instance dalam MIG dengan membuat template instance baru dan menerapkan konfigurasi ke MIG. Template instance yang sudah ada tidak dapat diupdate.

Untuk mengetahui informasi selengkapnya tentang cara membuat template instance, lihat Membuat template instance. Untuk melihat template instance yang ada, lihat Mendapatkan, mencantumkan, dan menghapus template instance.

Konsol

  1. Buka halaman Template instance.

    Buka halaman Template instance

  2. Klik template instance yang ingin Anda salin dan perbarui.

  3. Klik Buat yang serupa.

  4. Luaskan bagian Advanced options, lalu luaskan bagian Networking.

  5. Di bagian Dynamic Network Interfaces, klik Add a Dynamic Network Interface dan lakukan hal berikut:

    1. Di kolom Interface type, pilih VPC.

    2. Di kolom Parent network interface, pilih vNIC induk untuk membuat NIC Dinamis.

    3. Di kolom VLAN ID, masukkan VLAN ID NIC Dinamis.

    4. Untuk Network dan Subnetwork, pilih jaringan dan subnetwork yang ingin digunakan.

    5. Pilih salah satu opsi berikut untuk jenis stack IP untuk NIC Dinamis:

      • IPv4 (single-stack)
      • IPv4 dan IPv6 (stack ganda)
      • IPv6 (single-stack)

    6. Untuk NIC Dinamis dengan alamat IPv4, lakukan hal berikut:

      1. Untuk Primary internal IPv4, pilih salah satu opsi berikut:

        • Ephemeral (Automatic) untuk menetapkan alamat IPv4 efemeral baru secara otomatis
        • Ephemeral (Custom) untuk menentukan alamat IPv4 efemeral baru secara manual
        • Alamat IPv4 internal statis yang dicadangkan dari daftar
        • Reserve static internal IPv4 address untuk mencadangkan dan menetapkan alamat IPv4 internal statis yang baru

      2. Untuk External IPv4 address, pilih salah satu opsi berikut:

        • Ephemeral untuk menetapkan alamat IPv4 efemeral baru
        • None untuk tidak menetapkan alamat IPv4 eksternal
        • Alamat IPv4 yang dicadangkan dari daftar
        • Reserve static external IP address untuk mencadangkan dan menetapkan alamat IPv4 eksternal statis yang baru

      3. Secara opsional, Anda dapat menetapkan satu atau beberapa rentang IP alias ke antarmuka jaringan. Untuk menetapkan rentang IP alias, lakukan hal berikut:

        1. Di Rentang IP alias, klik Tambahkan rentang IP.
        2. Di Rentang subnet, pilih rentang alamat IPv4 primer subnet atau rentang alamat IPv4 sekunder subnet yang akan digunakan.
        3. Untuk Rentang IP alias, masukkan rentang IP dalam notasi CIDR. Rentang ini harus merupakan rentang yang tidak digunakan dari rentang IP subnet yang Anda pilih.

        Untuk mengetahui informasi selengkapnya tentang cara menetapkan rentang IP alias ke antarmuka jaringan VM, lihat Mengonfigurasi rentang IP alias.

    7. Untuk NIC Dinamis dengan alamat IPv6, konfigurasi rentang alamat IPv6 internal atau eksternal, bergantung pada jenis akses subnet yang terhubung. Untuk Primary internal IPv6 address atau External IPv6 address, pilih dari opsi berikut:

      • Ephemeral (Automatic) untuk menetapkan rentang alamat IPv6 efemeral baru secara otomatis
      • Ephemeral (Custom) untuk menentukan rentang alamat IPv6 efemeral baru secara manual
      • Rentang alamat IPv6 statis yang dicadangkan dari daftar
      • Reserve static internal IPv6 address atau Reserve static external IPv6 address untuk mencadangkan dan menetapkan rentang alamat IPv6 statis yang baru

    8. Untuk menyelesaikan pengeditan properti NIC Dinamis, klik Selesai.

  6. Untuk membuat template instance, klik Create.

  7. Ikuti langkah-langkah untuk menerapkan konfigurasi VM baru di MIG.

    Jika Anda ingin mengupdate instance tanpa memulai ulang atau membuatnya ulang, tetapkan tindakan minimal ke REFRESH. Untuk informasi selengkapnya, lihat referensi berikut:

gcloud

  1. Untuk membuat template instance baru yang menambahkan NIC Dinamis, gunakan perintah gcloud compute instance-templates create.

    Sertakan flag --network-interface untuk setiap antarmuka jaringan dari template instance yang ada dan tambahkan antarmuka jaringan baru yang menentukan kunci vlan untuk membuat NIC Dinamis.

    Contoh berikut menambahkan NIC Dinamis di nic0. Anda dapat menentukan antarmuka dan properti jaringan tambahan sesuai kebutuhan. Untuk mengetahui contoh lainnya tentang cara membuat instance dengan beberapa antarmuka jaringan, lihat Membuat VM dengan beberapa antarmuka jaringan.

    gcloud compute instance-templates create INSTANCE_TEMPLATE_NAME \
   --network-interface=network=NETWORK_A,subnet=SUBNET_A \
   --network-interface=network=NETWORK_B,subnet=SUBNET_B,vlan=VLAN_ID

    Ganti kode berikut:

    • INSTANCE_TEMPLATE_NAME: nama untuk template instance baru.
    • NETWORK_A, NETWORK_B: jaringan tempat antarmuka dipasang.
    • SUBNET_A, SUBNET_B: subnet tempat antarmuka dipasang.
    • VLAN_ID: ID VLAN. Menentukan ID VLAN akan mengonfigurasi antarmuka jaringan sebagai NIC Dinamis. Anda harus menempatkan NIC Dinamis setelah vNIC induknya dalam perintah.

  2. Ikuti langkah-langkah untuk menerapkan konfigurasi VM baru di MIG.

    Jika Anda ingin mengupdate instance tanpa memulai ulang atau membuatnya ulang, tetapkan tindakan minimal ke REFRESH. Untuk informasi selengkapnya, lihat referensi berikut:

API

  1. Untuk membuat template instance baru yang menambahkan NIC Dinamis, gunakan metode instanceTemplates.insert untuk membuat template instance global atau metode regionInstanceTemplates.insert untuk membuat template instance regional.

    Di kolom networkInterfaces, tentukan setiap antarmuka jaringan dari template instance yang ada dan tambahkan antarmuka jaringan baru yang menyertakan kolom vlan untuk membuat NIC Dinamis.

    Contoh berikut menambahkan NIC Dinamis di nic0. Anda dapat menentukan antarmuka dan properti jaringan tambahan sesuai kebutuhan. Untuk contoh lainnya tentang cara membuat instance dengan beberapa antarmuka jaringan, lihat Membuat VM dengan beberapa antarmuka jaringan.

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/instanceTemplates
{
   ....

   "networkInterfaces": [
     {
       "subnetwork": "regions/REGION/subnetworks/SUBNET_A"
     },
     {
       "subnetwork": "regions/REGION/subnetworks/SUBNET_B",
       "vlan": "VLAN_ID"
     },
       additional network interfaces...
   ],
   other instance settings...
 }

    Ganti kode berikut:

    • PROJECT_ID: ID project yang berisi template instance.
    • REGION: region yang berisi instance.
    • SUBNET_A, SUBNET_B: subnet tempat setiap antarmuka jaringan berada.
    • VLAN_ID: ID VLAN. Menentukan ID VLAN akan mengonfigurasi antarmuka jaringan sebagai NIC Dinamis. Anda harus menempatkan NIC Dinamis setelah vNIC induknya dalam permintaan.

  2. Ikuti langkah-langkah untuk menerapkan konfigurasi VM baru di MIG.

    Jika Anda ingin mengupdate instance tanpa memulai ulang atau membuatnya ulang, tetapkan tindakan minimal ke REFRESH. Untuk informasi selengkapnya, lihat referensi berikut:

Mengonfigurasi OS tamu untuk NIC Dinamis

Bagian ini menjelaskan cara menyelesaikan konfigurasi OS tamu tambahan yang diperlukan saat Anda menambahkan NIC Dinamis ke instance baru atau yang sudah ada.

Pilih salah satu opsi konfigurasi berikut:

Opsi konfigurasi Deskripsi
Mengonfigurasi pengelolaan otomatis NIC Dinamis (Direkomendasikan)

Gunakan agen tamu untuk pengelolaan otomatis NIC Dinamis.

Lingkungan tamu mencakup agen tamu, yang mengotomatiskan penginstalan dan pengelolaan antarmuka VLAN di namespace root pada distribusi Linux dari image OS Google Cloud .

Jika Anda mengonfigurasi pengelolaan otomatis NIC Dinamis, gunakan agen tamu versi 20251115.00 atau yang lebih baru. Meskipun dukungan untuk fungsi ini diperkenalkan di agen tamu versi 20250204.02, ada masalah umum dengan agen tamu versi 20250901.00 hingga 20251108.00 di mana NIC Dinamis tidak diinstal dan dikelola secara otomatis.
Mengonfigurasi OS tamu secara manual

Jalankan perintah di OS tamu untuk menginstal NIC Dinamis.

Jika Anda menggunakan opsi ini, konfigurasi Anda tidak akan otomatis dipertahankan setelah instance dimulai ulang. Agar konfigurasi tetap ada setelah dimulai ulang, gunakan metode yang direkomendasikan untuk mengonfigurasi antarmuka jaringan persisten untuk distribusi Linux Anda. Misalnya, lihat NetworkConfiguration untuk Debian dan interfaces untuk Ubuntu.

Mengonfigurasi pengelolaan otomatis NIC Dinamis

Bagian ini menjelaskan cara mengonfigurasi pengelolaan otomatis NIC Dinamis menggunakan agen tamu.

Anda hanya perlu menyelesaikan langkah-langkah ini satu kali per instance. Jika Anda menambahkan NIC Dinamis ke instance yang telah menyelesaikan langkah-langkah ini, Anda tidak perlu mengulanginya.

Untuk mengonfigurasi pengelolaan otomatis NIC Dinamis:

  1. Hubungkan ke instance menggunakan SSH.

  2. Pastikan instance menjalankan agen tamu versi 20251115.00 atau yang lebih baru:

    1. Untuk menentukan apakah instance menjalankan agen tamu, jalankan perintah yang sesuai yang tercantum di Paket yang diinstal untuk lingkungan tamu.

      1. Jika instance Anda tidak menjalankan agen tamu, instal lingkungan tamu.

      2. Jika instance Anda menjalankan agen tamu, perbarui lingkungan tamu.

      Menginstal atau mengupdate lingkungan tamu memastikan Anda memiliki versi terbaru agen tamu. Anda dapat mengonfirmasi versi dengan mengikuti langkah-langkah di bagian Memvalidasi lingkungan tamu.

  3. Konfigurasi agen tamu untuk mengelola NIC Dinamis:

    1. Buka atau buat file konfigurasi lingkungan tamu Anda.

      edit /etc/default/instance_configs.cfg

    2. Tambahkan kode berikut ke file konfigurasi, lalu simpan perubahan dan keluar dari editor.

      [NetworkInterfaces]
vlan_setup_enabled = true
manage_primary_nic = true

      Untuk mengetahui informasi tentang setelan ini, lihat berikut:

      • vlan_setup_enabled = true: mengonfigurasi agen tamu untuk menginstal dan mengelola NIC Dinamis
      • manage_primary_nic = true: setelan tambahan yang diperlukan agar agen tamu dapat mengelola NIC Dinamis yang dibuat di nic0

      Untuk mengetahui informasi selengkapnya tentang cara mengedit file konfigurasi agen tamu, lihat Konfigurasi dalam dokumentasi agen tamu.

    3. Mulai ulang agen tamu dengan menjalankan perintah berikut. Atau, Anda dapat memulai ulang instance.

      sudo systemctl restart google-guest-agent.service

  4. Mencantumkan antarmuka jaringan di instance Anda untuk melihat bahwa agen tamu menginstal NIC Dinamis Anda.

    Misalnya, perintah berikut menampilkan nama seperti a-gcp.ens4.11 untuk NIC Dinamis dengan ID VLAN 11 yang dibuat sebagai turunan dari antarmuka ens4.

    sudo ip -d addr

Mengonfigurasi OS tamu secara manual

Untuk mengonfigurasi NIC Dinamis di OS tamu instance secara manual:

  1. Hubungkan ke instance menggunakan SSH.

  2. Jika instance menjalankan agen tamu, nonaktifkan pengelolaan otomatis NIC Dinamis. Anda dapat menentukan apakah instance menjalankan agen tamu dengan menggunakan perintah yang sesuai yang tercantum di Paket yang diinstal untuk lingkungan tamu.

    Untuk menonaktifkan pengelolaan otomatis NIC Dinamis:

    1. Buka atau buat file konfigurasi lingkungan tamu Anda.

        edit /etc/default/instance_configs.cfg

    2. Tambahkan kode berikut ke file konfigurasi, lalu simpan perubahan dan keluar dari editor.

      [NetworkInterfaces]
vlan_setup_enabled = false
manage_primary_nic = false

      Untuk mengetahui informasi selengkapnya tentang cara mengedit file konfigurasi agen tamu, lihat Konfigurasi dalam dokumentasi agen tamu.

    3. Mulai ulang agen tamu dengan menjalankan perintah berikut. Atau, Anda dapat memulai ulang instance.

      sudo systemctl restart google-guest-agent.service

  3. Untuk setiap NIC Dinamis yang Anda buat, lakukan hal berikut:

    1. Dapatkan alamat MAC NIC Dinamis. Untuk menemukan alamat MAC, buat kueri server metadata dengan menjalankan perintah berikut:

      curl http://metadata.google.internal/computeMetadata/v1/instance/vlan-network-interfaces/VNIC_NUMBER/VLAN_ID/mac -H "Metadata-Flavor: Google"

      Ganti VNIC_NUMBER/VLAN_ID dengan jumlah vNIC induk dan ID VLAN NIC Dinamis. Misalnya, 0/2 untuk nic0.2 atau 1/4 untuk nic1.4.

    2. Konfigurasi subantarmuka di OS tamu instance. Misalnya, di VM Debian, jalankan perintah berikut:

      sudo modprobe 8021q
sudo ip link add link VNIC_NAME name VNIC_NAME.VLAN_ID type vlan id VLAN_ID
sudo ip addr add IP_ADDRESS dev VNIC_NAME.VLAN_ID
sudo ip link set dev VNIC_NAME.VLAN_ID address MAC_ADDRESS
sudo ip link set up VNIC_NAME.VLAN_ID

      Ganti kode berikut:

      • VNIC_NAME: nama vNIC induk yang ditetapkan oleh sistem operasi, seperti eth1 atau ens4
      • IP_ADDRESS: alamat IP NIC Dinamis yang Anda buat
      • VLAN_ID: ID VLAN yang Anda tetapkan ke NIC Dinamis
      • MAC_ADDRESS: alamat MAC yang Anda peroleh pada langkah sebelumnya

Langkah berikutnya