全部产品
Search
文档中心

Elastic Container Instance:Dapatkan metadata dari sebuah container

更新时间:Jun 29, 2025

Metadata dari instans elastis container menyediakan informasi tentang instans dan container di dalamnya untuk mempermudah penggunaan dan pengelolaan. Metadata mencakup informasi dasar seperti nama instans, ID instans, serta informasi jaringan seperti alamat IP dan antarmuka kontrol jaringan (NIC). Topik ini menjelaskan cara mendapatkan metadata dari instans elastis container dan menyajikan metadata kepada container yang sedang berjalan.

Metode 1: Gunakan MetaServer untuk mengakses metadata

  1. Hubungkan ke sebuah container. Untuk detail lebih lanjut, lihat Hubungkan ke instans elastis container.

  2. Akses metadata.

    Catatan

    Jika curl belum terinstal di dalam container, instal curl terlebih dahulu.

    curl http://100.100.100.200/latest/meta-data/<metadata>

    Ganti <metadata> dengan item metadata yang ingin diperiksa. Sebagai contoh, ganti <metadata> dengan instance-id.

    curl http://100.100.100.200/latest/meta-data/instance-id

    Tabel berikut menjelaskan item metadata dari instans elastis container yang dapat diperiksa.

    Item metadata

    Deskripsi

    /dns-conf/nameservers

    Konfigurasi Domain Name System (DNS) dari instans elastis container.

    /eipv4

    Alamat IPv4 elastis dari instans elastis container.

    /hostname

    Nama host dari instans elastis container, yaitu nilai ContainerGroupName.

    /instance-id

    ID dari instans elastis container.

    /mac

    Alamat media access control (MAC) dari instans elastis container.

    /network/interfaces/

    Alamat MAC dari NIC.

    /network/interfaces/macs/[mac]/network-interface-id

    ID dari NIC. Ganti [mac] dengan alamat MAC dari instans elastis container.

    /network/interfaces/macs/[mac]/netmask

    Subnet mask dari NIC.

    /network/interfaces/macs/[mac]/vswitch-cidr-block

    Blok CIDR IPv4 dari vSwitch tempat NIC terhubung.

    /network/interfaces/macs/[mac]/vpc-cidr-block

    Blok CIDR IPv4 dari virtual private cloud (VPC) tempat NIC berada.

    /network/interfaces/macs/[mac]/private-ipv4s

    Alamat IPv4 privat yang ditetapkan ke NIC.

    /network/interfaces/macs/[mac]/vpc-ipv6-cidr-blocks

    Blok CIDR IPv6 dari VPC tempat NIC berada. Item ini hanya berlaku untuk instans elastis container yang berada di dalam VPC dan memiliki alamat IPv6 yang ditetapkan.

    /network/interfaces/macs/[mac]/vswitch-id

    ID dari vSwitch yang berada di dalam VPC yang sama dengan grup keamanan NIC.

    /network/interfaces/macs/[mac]/vpc-id

    ID dari VPC tempat grup keamanan NIC berada.

    /network/interfaces/macs/[mac]/primary-ip-address

    Alamat IP privat utama dari NIC.

    /network/interfaces/macs/[mac]/gateway

    Alamat gateway IPv4 dari NIC.

    /instance/max-netbw-egress

    Bandwidth keluar maksimum internal dari instans elastis container. Satuan: Kbit/s.

    /instance/max-netbw-ingerss

    Bandwidth masuk maksimum internal dari instans elastis container. Satuan: Kbit/s.

    /network/interfaces/macs/[mac]/ipv6s

    Alamat IPv6 yang ditetapkan ke NIC. Item ini hanya berlaku untuk instans elastis container yang berada di dalam VPC dan memiliki alamat IPv6 yang ditetapkan.

    /network/interfaces/macs/[mac]/ipv6-gateway

    Alamat gateway IPv6 dari VPC tempat NIC berada.

    /network/interfaces/macs/[mac]/vswitch-ipv6-cidr-block

    Blok CIDR IPv6 dari vSwitch tempat NIC terhubung. Item ini hanya berlaku untuk instans elastis container yang berada di dalam VPC dan memiliki alamat IPv6 yang ditetapkan.

    /private-ipv4

    Alamat IPv4 privat dari instans elastis container.

    /ntp-conf/ntp-servers

    Alamat dari server Network Time Protocol (NTP).

    /owner-account-id

    ID akun Alibaba Cloud tempat instans elastis container berada.

    /region-id

    ID wilayah dari instans elastis container.

    /serial-number

    Nomor seri dari instans elastis container.

    /vpc-id

    ID dari VPC tempat instans elastis container berada.

    /vpc-cidr-block

    Blok CIDR dari VPC tempat instans elastis container berada.

    /vswitch-cidr-block

    Blok CIDR dari vSwitch tempat instans elastis container terhubung.

    /vswitch-id

    ID dari vSwitch tempat instans elastis container terhubung.

    /zone-id

    ID zona dari instans elastis container.

    /ram/security-credentials/[role-name]

    Kredensial Security Token Service (STS) sementara yang dihasilkan untuk Resource Access Management (RAM) role dari instans elastis container. Anda hanya bisa mendapatkan kredensial STS sementara setelah menentukan RAM role untuk instans elastis container. Ganti [role-name] dengan nama RAM role. Jika Anda tidak mengganti [role-name] dengan nama RAM role, nama instans elastis container akan dikembalikan.

Metode 2: Konfigurasikan variabel lingkungan untuk sebuah container

Anda dapat memperoleh informasi tentang instans elastis container dengan mengonfigurasi variabel lingkungan untuk sebuah container pada instans tersebut. Item metadata yang dapat diperoleh meliputi ID instans, nama instans, ID wilayah instans, ID zona instans, dan nama container.

Kunci

Nilai

Deskripsi

eci_id

__ECI_ID__

ID dari instans elastis container.

eci_name

__ECI_NAME__

Nama dari instans elastis container.

region_id

__REGION_ID__

ID wilayah dari instans elastis container.

zone_id

__ZONE_ID__

ID zona dari instans elastis container.

container_name

__CONTAINER_NAME__

Nama dari container.

Contoh:

OpenAPI

Saat memanggil operasi CreateContainerGroup untuk membuat instans elastis container, Anda dapat menggunakan parameter Container.N.EnvironmentVar.N.Key dan Container.N.EnvironmentVar.N.Value untuk mengonfigurasi variabel lingkungan, seperti yang ditunjukkan dalam kode sampel berikut:

ContainerGroupName=test-env
Container.1.Image=registry-vpc.cn-shanghai.aliyuncs.com/eci_open/nginx:1.14.2
Container.1.Name=container-1
# Konfigurasikan variabel lingkungan.
Container.1.EnvironmentVar.1.Key=eci_id
Container.1.EnvironmentVar.2.Key=eci_name
Container.1.EnvironmentVar.3.Key=region_id
Container.1.EnvironmentVar.4.Key=zone_id
Container.1.EnvironmentVar.5.Key=container_name
Container.1.EnvironmentVar.1.Value=__ECI_ID__
Container.1.EnvironmentVar.2.Value=__ECI_NAME__
Container.1.EnvironmentVar.3.Value=__REGION_ID__
Container.1.EnvironmentVar.4.Value=__ZONE_ID__
Container.1.EnvironmentVar.5.Value=__CONTAINER_NAME__

Konsol

Saat membuat instans elastis container di Konsol Elastic Container Instance, pilih container di bagian Container Configurations, perluas Pengaturan Lanjutan dari container, aktifkan Environment Variable, dan tambahkan variabel lingkungan, seperti yang ditunjukkan pada gambar berikut.

元数据.png

Setelah instans elastis container dibuat, Anda dapat menghubungkan ke container untuk memeriksa apakah variabel lingkungan yang telah dikonfigurasi telah diterapkan. Untuk informasi lebih lanjut, lihat Hubungkan ke instans elastis container.view