Az Azure CLI konfigurálása
Az Azure CLI lehetővé teszi, hogy a felhasználók konfiguráljanak bizonyos beállításokat, például a naplózást, az adatgyűjtést és az alapértelmezett argumentumértékeket. A parancssori felület egy egyszerű parancsot kínál néhány alapértelmezett beállítás kezeléséhez, az configés egy interaktív lehetőséget is.az init Egyéb értékek egy konfigurációs fájlban vagy környezeti változók használatával állíthatók be. Ez a cikk további információkat tartalmaz ezekről a felhasználói konfigurációs beállításokról, valamint az Azure CLI konfigurálásáról.
A rendszer a parancssori felület által használt konfigurációs értékeket a következő elsőbbségi sorrendben értékeli ki (a listában előbb szereplő elemek élveznek elsőbbséget).
- Parancssori paraméterek
- Környezeti változók
- A konfigurációs fájlkészlet értékei a következőkkel
az config:az init
Beállítások konfigurálása az init használatával
Az Azure CLI-konfigurációk beállításának legegyszerűbb módja az interaktív az init parancs használata. Válasszon ki egy gyakori konfigurációt, például az "interakciót" vagy az "automatizálást", vagy válasszon egyéni konfigurációkat. Ami különösen hasznos ebben a megközelítésben, az az init az oka annak, hogy miért érdemes egy másik konfigurációs lehetőséget választania.
az init
Beállítások konfigurálása az az config használatával
A parancssori felület alapértelmezett beállításai az az config set paranccsal állíthatók be .
Ez a parancs argumentumként a párok szóközzel elválasztott listáját key=value veszi fel. A megadott értékeket az Azure CLI használja a szükséges argumentumok helyett.
Az alábbi táblázat az elérhető konfigurációs kulcsok listáját tartalmazza.
| Név | Leírás |
|---|---|
| defaults.group | Az összes parancsra vonatkozó alapértelmezett erőforráscsoport. |
| defaults.location | Az összes parancsra vonatkozó alapértelmezett hely. |
| defaults.web | Az az webapp parancsokra vonatkozó alapértelmezett alkalmazásnév. |
| defaults.vm | Az az vm parancsokra vonatkozó alapértelmezett virtuálisgép-név. |
| defaults.vmss | A parancsokhoz az vmss használandó alapértelmezett virtuálisgép-méretezési csoport (VMSS) neve. |
| defaults.acr | Az az acr parancsokra vonatkozó alapértelmezett tárolóregisztrációs adatbázis neve. |
Például így állíthatja be az összes parancsra vonatkozó erőforráscsoportot és helyet:
az config set defaults.location=westus2 defaults.group=MyResourceGroup
Az alábbi parancs kikapcsolja a felmérési hivatkozásokat az Azure CLI-parancsok végrehajtása közben:
az config set output.show_survey_link=no
Parancssori felületi konfigurációs fáj
A parancssori felületi konfigurációs fájl a parancssori felület viselkedésére vonatkozó egyéb beállításokat tartalmaz. Maga a konfigurációs fájl itt található: $AZURE_CONFIG_DIR/config. Az AZURE_CONFIG_DIR alapértelmezett értéke a Linux és macOS rendszereken $HOME/.azure, a Windows rendszeren pedig %USERPROFILE%\.azure.
A konfigurációs fájlok INI fájlformátumban íródnak. A szakaszfejlécek határozzák meg a fájlformátumot, majd a kulcs-érték bejegyzések listáját.
- A szakaszfejlécek formátuma:
[section-name]. A szakasznevek megkülönböztetik a kis- és nagybetűket. - A bejegyzések formátuma:
key=value. A kulcsnevek nem megkülönböztetik a kis- és nagybetűket. - Minden olyan sor megjegyzésnek számít, amely
#vagy;karakterrel kezdődik. Beágyazott megjegyzések nem engedélyezettek.
A logikai értékek nem érzékenyek a kis- és nagybetűkre. A következő értékek logikai értékeket jelölnek:
- Igaz:
1,yes, ,trueon - Hamis:
0,no,falseoff
Az alábbiakban egy példát láthat egy parancssori felületi konfigurációs fájlra, amely letilt minden megerősítési kérést, és a naplózás helyeként a /var/log/azure könyvtárat állítja be.
[core]
disable_confirm_prompt=Yes
[logging]
enable_log_file=yes
log_dir=/var/log/azure
További részleteket az összes elérhető konfigurációs értékről és jelentésükről a következő szakaszban talál. Az INI fájlformátummal kapcsolatos részletes információkért tekintse meg a Python az INI-vel foglalkozó dokumentációját.
A parancssori felület konfigurációs értékei és környezeti változói
A következő táblában található minden konfigurációs fájlba helyezhető szakasz és beállításnév. A vonatkozó környezeti változók a következőképpen adhatók meg: AZURE_{section}_{name} (nagybetűkkel írva). Az alapértelmezett érték például a változóban van beállítva, az storage_account alapértelmezett érték batchai a AZURE_BATCHAI_STORAGE_ACCOUNT változóban, az alapértelmezett location érték pedig a AZURE_DEFAULTS_LOCATION változóban van beállítva.AZURE_CORE_OUTPUToutputcore
Ha megad egy alapértelmezett értéket, a parancsoknak már nincs szüksége az argumentumra. Helyette az alapértelmezett értéket használja a rendszer.
| Szakasz | Név | Típus | Leírás |
|---|---|---|---|
| core | output | húr | Az alapértelmezett kimeneti formátum. Engedélyezett értékek: json (alapértelmezett), jsonc, yaml, yamlc, table, tsv. none További információkért tekintse meg az Azure CLI-parancsok kimeneti formátumait. |
| disable_confirm_prompt | Logikai | Megerősítési kérések be-/kikapcsolása. | |
| display_region_identified | Logikai | Az Azure-ügyfelek számos különböző régióban helyezhetnek üzembe erőforrásokat. Bizonyos esetekben az ügyfelek csökkenthetik a költségeket az azonos szolgáltatásokat kínáló közeli régiók kiválasztásával. Ha egy közeli régiót azonosít, egy üzenet jelenik meg a jövőbeli üzembe helyezéshez kiválasztandó régióról. Ez a beállítás szabályozza, hogy megjelenik-e az üzenet. | |
| collect_telemetry | Logikai | Engedélyezi, hogy a Microsoft névtelen adatokat gyűjtsön a parancssori felület használatával kapcsolatban. Az adatvédelmi információkért tekintse meg az Azure CLI MIT-licencet. | |
| only_show_errors | Logikai | Csak a parancshívás során jelenítse meg a hibákat. Más szóval csak a hibák vannak megírva.stderr Letiltja a figyelmeztetéseket az előzetes verzióból, az elavult és a kísérleti parancsokból. A paraméterrel rendelkező --only-show-errors egyes parancsokhoz is elérhető. |
|
| no_color | Logikai | Tiltsa le a színt. Az eredetileg színes üzenetek előtagja DEBUGaz , WARNINGINFOés ERROR. Ez a logikai érték egy harmadik féltől származó kódtár problémáját adja át, ahol a terminál színe nem állítható vissza átirányítás után stdout . |
|
| Ügyfelek | show_secrets_warning | Logikai | Kapcsolja be/ki a bizalmas információk kimenetére vonatkozó figyelmeztetést. |
| logging | enable_log_file | Logikai | Naplózás be-/kikapcsolása. |
| log_dir | húr | A könyvtár, ahová a naplófájlok íródnak. Alapértelmezés szerint ez az érték: ${AZURE_CONFIG_DIR}/logs*. |
|
| Alapértelmezett | csoport | húr | Az összes parancsra vonatkozó alapértelmezett erőforráscsoport. |
| hely | húr | Az összes parancsra vonatkozó alapértelmezett hely. | |
| web | húr | Az az webapp parancsokra vonatkozó alapértelmezett alkalmazásnév. |
|
| vm | húr | Az az vm parancsokra vonatkozó alapértelmezett virtuálisgép-név. |
|
| vmss | húr | A parancsokhoz az vmss használandó alapértelmezett virtuálisgép-méretezési csoport (VMSS) neve. |
|
| acr | húr | Az az acr parancsokra vonatkozó alapértelmezett tárolóregisztrációs adatbázis neve. |
|
| storage | account | húr | A tárfiók alapértelmezett neve (például mystorageaccount in https://mystorageaccount.blob.core.windows.net) adatsík-parancsokhoz az storage (példáulaz storage container list). |
| kulcs | húr | Az adatsík-parancsokhoz az storage használandó alapértelmezett hozzáférési kulcs. |
|
| sas_token | húr | Az adatsík-parancsokhoz az storage használandó alapértelmezett SAS-jogkivonat. |
|
| connection_string | húr | Az alapértelmezett kapcsolati sztring adatsík-parancsokhozaz storage. |
|
| batchai | storage_account | húr | Az az batchai parancsokra vonatkozó alapértelmezett tárfiók. |
| storage_key | húr | Az az batchai parancsokra vonatkozó alapértelmezett tárkulcs. |
|
| batch | account | húr | Az az batch parancsokra vonatkozó alapértelmezett Azure Batch-fióknév. |
| access_key | húr | Az az batch parancsokra vonatkozó alapértelmezett hozzáférési kulcs. Csak az aad-hitelesítéssel használatos. |
|
| endpoint | húr | Az az batch parancsokra vonatkozó alapértelmezett csatlakozási végpont. |
|
| auth_mode | húr | Az az batch parancsokra vonatkozó alapértelmezett hitelesítési mód. Engedélyezett értékek: shared_key, aad. |
|
| Felhő | név | húr | Az összes az parancs alapértelmezett felhője. Engedélyezett értékek: AzureCloud (alapértelmezett), AzureChinaCloud, AzureUSGovernment. A felhők módosításához használja a az cloud set –name parancsot. Példa: Felhők kezelése az Azure CLI-vel. |
| Kiterjesztés | use_dynamic_install | húr | Telepítsen egy bővítményt, ha még nincs hozzáadva egy parancs futtatásakor. Engedélyezett értékek: no (alapértelmezett), yes_prompt, yes_without_prompt. |
| run_after_dynamic_install | Logikai | Futtassa tovább a parancsot, ha egy bővítmény dinamikusan van telepítve hozzá. Az alapértelmezett szint a False. |
|
| index_url | húr | A privát bővítmény indexfájljának URL-címe a index.json formátumát követve. Miután megadta, a az extension add --name <extension-name> végrehajtás a fájl használatával keresi meg a hozzáadni kívánt bővítményt. |
Feljegyzés
Más értékek is szerepelhetnek a konfigurációs fájlban, de ezek közvetlenül parancssori felületi parancsokkal kezelhetők, beleértve az az config parancsot is. A táblázatban korábban felsorolt értékek az egyetlenek, amelyeket módosítania kell.