Variabel lingkungan untuk Alibaba Cloud CLI - Alibaba Cloud CLI

Alibaba Cloud CLI mendukung konfigurasi kredensial, wilayah, opsi perilaku, dan parameter waktu proses lainnya melalui variabel lingkungan. Dalam pipeline CI/CD, lingkungan container, atau skrip otomatisasi, variabel lingkungan merupakan metode yang direkomendasikan untuk meneruskan kredensial dan konfigurasi waktu proses. Topik ini mencantumkan semua variabel lingkungan yang didukung serta menjelaskan urutan prioritasnya agar Anda dapat dengan cepat menemukan item konfigurasi yang diperlukan.

Urutan prioritas

Saat membaca konfigurasi, Alibaba Cloud CLI menerapkan pengaturan berdasarkan urutan prioritas berikut, dari tertinggi ke terendah:

Parameter command line (seperti --profile dan --region)
File konfigurasi (~/.aliyun/config.json)
Variabel lingkungan

Untuk informasi lebih lanjut, lihat Memahami parameter command line.

Kredensial dan identitas

Gunakan variabel lingkungan untuk mengonfigurasi informasi kredensial seperti AccessKey, token Security Token Service (STS), OpenID Connect (OIDC), dan RAM role tanpa menyimpan rahasia dalam teks biasa di file konfigurasi.

Variabel lingkungan	Deskripsi
`ALIBABA_CLOUD_ACCESS_KEY_ID`	ID AccessKey.
`ALIBABA_CLOUD_ACCESS_KEY_SECRET`	Rahasia AccessKey.
`ALIBABA_CLOUD_SECURITY_TOKEN`	Token keamanan sementara STS. Gunakan bersama dengan ID AccessKey dan rahasia AccessKey.
`ALIBABA_CLOUD_CREDENTIALS_URI`	Titik akhir layanan kredensial untuk mode CredentialsURI. Tidak tersedia alias.
`ALIBABA_CLOUD_OIDC_PROVIDER_ARN`	ARN (Nama Sumber Daya Alibaba Cloud) dari penyedia identitas OIDC.
`ALIBABA_CLOUD_OIDC_TOKEN_FILE`	Jalur ke file token OIDC.
`ALIBABA_CLOUD_ROLE_ARN`	ARN Peran RAM, digunakan dengan mode otentikasi RamRoleArn dan ChainableRamRoleArn.
`ALIBABA_CLOUD_EXTERNAL_ID`	ID Eksternal, digunakan dalam skenario asumsi peran lintas akun (cross-account).
`ALIBABA_CLOUD_SSO_CLIENT_ID`	ID client OIDC Cloud SSO. Jika diatur, nilai ini akan menggantikan ID client bawaan CLI.

Untuk metode konfigurasi dan skenario penerapan masing-masing jenis kredensial, lihat Konfigurasikan kredensial.

Pemilihan profil

Kontrol profil mana yang digunakan oleh CLI.

Variabel lingkungan	Deskripsi
`ALIBABA_CLOUD_PROFILE`	Menentukan nama profil yang akan digunakan. Setara dengan parameter `--profile`.
`ALIBABA_CLOUD_IGNORE_PROFILE`	Jika diatur ke `TRUE` (harus huruf kapital dan peka huruf besar/kecil), CLI akan mengabaikan profil dalam file konfigurasi dan hanya menggunakan kredensial yang disediakan melalui variabel lingkungan.

Wilayah dan titik akhir

Variabel lingkungan	Deskripsi
`ALIBABA_CLOUD_REGION_ID`	ID wilayah default, seperti `cn-hangzhou`.
`ALIBABA_CLOUD_ENDPOINT`	Alamat titik akhir API kustom. Jika diatur, CLI akan mengirim permintaan langsung ke alamat ini dan melewati resolusi titik akhir otomatis.
`ALIBABA_CLOUD_ENDPOINT_TYPE`	Jenis titik akhir. Misalnya, atur ke `vpc` untuk menggunakan titik akhir jaringan pribadi VPC. Biarkan kosong atau tidak diatur untuk menggunakan titik akhir jaringan publik.

Manajemen plugin

Kontrol perilaku instalasi otomatis plugin, lokasi penyimpanan, dan sumber unduhan.

Variabel lingkungan	Deskripsi
`ALIBABA_CLOUD_CLI_PLUGIN_AUTO_INSTALL`	Jika diatur ke `true`, CLI akan secara otomatis menginstal plugin yang belum tersedia saat memanggil perintah plugin.
`ALIBABA_CLOUD_CLI_PLUGIN_AUTO_INSTALL_ENABLE_PRE`	Jika diatur ke `true`, memungkinkan instalasi otomatis versi plugin pra-rilis (pre-release).
`ALIBABA_CLOUD_CLI_PLUGINS_DIR`	Direktori instalasi plugin kustom. Nilai default adalah `~/.aliyun/plugins/`.
`ALIBABA_CLOUD_CLI_PLUGIN_NO_CACHE`	Jika diatur ke `true` atau `1`, cache indeks plugin dilewati dan indeks terbaru diambil dari sumber remote setiap kali.
`ALIBABA_CLOUD_CLI_PLUGIN_SOURCE_BASE`	URL dasar untuk sumber unduhan plugin kustom. Berguna dalam lingkungan jaringan pribadi atau skenario image privat.

Jaringan, timeout, dan bahasa

CLI secara otomatis meneruskan pengaturan berikut dari profil saat ini ke proses anak plugin. Untuk menyesuaikan kebijakan timeout dan retry, gunakan perintah aliyun configure atau edit langsung file konfigurasi.

Variabel lingkungan	Deskripsi
`ALIBABA_CLOUD_READ_TIMEOUT`	Timeout baca I/O, dalam satuan detik.
`ALIBABA_CLOUD_CONNECT_TIMEOUT`	Timeout koneksi, dalam satuan detik.
`ALIBABA_CLOUD_RETRY_COUNT`	Jumlah percobaan ulang saat permintaan gagal.
`ALIBABA_CLOUD_LANGUAGE`	Pengaturan bahasa CLI. Nilai yang valid adalah `en` (Inggris) atau `zh` (Tionghoa).