Ortamınızı Azure CLI’ye hazırlama

Makale
12/06/2023

Bu öğretici adımında ilk Azure CLI komutlarınızı yürütürsiniz! Bu, etkin aboneliğinizi bulup ayarlamayı ve varsayılan değerleri ayarlamayı içerir. Ayrıca, benzersiz bir kaynak adını her zaman garanti etmek için rastgele bir kimlik içeren kaynak grupları oluşturmayı da öğrenirsiniz.

Azure aboneliğiniz yoksa başlamadan önce birücretsiz Azure hesabı oluşturun.

Bu öğretici adımını tamamlamak için aboneliğinizde veya daha yüksek izinlere sahip olmanız gerekir contributor .

Azure CLI'yi yükleme

Önce ortamınızı seçerek başlayın.

Her Azure CLI kod bloğunun sağ üst köşesindeki Cloud Shell'i Aç düğmesini seçerek Azure Cloud Shell'de Bash ortamını kullanın.
Azure CLI başvuru komutlarını yerel olarak çalıştırmayı tercih ediyorsanız Azure CLI'yı yükleyin .

Azure CLI'nın geçerli sürümü 2.61.0'dır. En son sürüm hakkında bilgi edinmek için sürüm notlarına bakın. Yüklü sürümünüzü bulmak ve güncelleştirmeniz gerekip gerekmediğini görmek için az version komutunu çalıştırın.

Azure CLI ile çalışırken çeşitli kimlik doğrulama seçenekleri vardır. Azure CLI'nın oturum açma işlemleri için varsayılan kimlik doğrulama yöntemi, oturum açmak için bir web tarayıcısı ve erişim belirteci kullanır.

az login komutunu çalıştırın.
```
az login
```
Azure CLI varsayılan tarayıcınızı açabiliyorsa yetkilendirme kodu akışını başlatır ve azure oturum açma sayfasını yüklemek için varsayılan tarayıcıyı açar.

Aksi takdirde, cihaz kodu akışını başlatır ve adresinde https://aka.ms/deviceloginbir tarayıcı sayfası açmanız için size talimat verir. Ardından terminalinizde görüntülenen kodu girin.

Kullanılabilir web tarayıcısı yoksa veya web tarayıcısı açılamıyorsa az login --use-device-code ile cihaz kodu akışını zorlayabilirsiniz.
Tarayıcıda hesabınızın kimlik bilgileriyle oturum açın.

Etkin aboneliğinizi bulma ve değiştirme

Azure CLI'da oturum açtıktan sonra her zaman geçerli aboneliğinizi denetleyin. Tercih ettiğiniz abonelik altında çalışmıyorsanız az account set komutunu kullanarak aboneliğinizi değiştirin. Aşağıdaki kod örneğini kullanabilirsiniz:

# see your current/default subscription
az account show

# find the list of subscriptions available to you
az account list --output table

# change your current/default subscription
az account set --subscription <mySubscriptionName>

# you can also set your subscription using a subscription ID
az account set --subscription <00000000-0000-0000-0000-000000000000>

Komut için az account show konsol çıkışı:

{
  "environmentName": "AzureCloud",
  "homeTenantId": "00000000-0000-0000-0000-000000000000",
  "id": "00000000-0000-0000-0000-000000000000",
  "isDefault": true,
  "managedByTenants": [],
  "name": "Your storage account name",
  "state": "Enabled",
  "tenantId": "00000000-0000-0000-0000-000000000000",
  "user": {
    "name": "yourName@contoso.com",
    "type": "user"
  }
}

Kaynak grupları hakkında bilgi edinin

Kaynak grubu, Azure kaynaklarına yönelik bir kapsayıcıdır. Kaynak grubu oluşturmak için aboneliğinizde izinlere veya daha üst bir sürüme sahip olmanız gerekir contributor .

Kaynak grubu oluşturma

Abonelik içinde kaynak grubu adı benzersiz olmalıdır. İlk olarak az group exists komutunu kullanarak istediğiniz adın kullanılabilir olup olmadığını denetleyin. çıkış değeri false , adın kullanılabilir olduğu anlamına gelir.
```
az group exists --name <myUniqueRGname>
```
az account list-locations komutuyla aboneliğiniz için desteklenen bölgelerin listesini alın. Kullanılabilir Azure konumlarının listesi için bkz . Sizin için doğru Azure bölgesini seçme.
```
az account list-locations --query "[].{Region:name}" --output table
```
Kaynak grubunuzu oluşturmanın zamanı geldi! az group create komutunu kullanın.
```
az group create --location <myLocation> --name <myUniqueRGname>
```

Rastgele kimlik içeren bir kaynak grubu oluşturma

Test ederken, adında rastgele bir kimlik içeren bir kaynak grubu oluşturmak en iyisidir. Kaynak grubu adınıza rastgele bir kimlik eklemek, aynı ada sahip önceki bir kaynak grubunun Azure'dan kaldırılmasını beklemek zorunda kalmadan kodunuzu yeniden test etmenizi sağlar.

Bash ve PowerShell değişken söz dizimi farklıdır. Ortamınız için doğru betiği kopyalayın.

Bash
PowerShell

let "randomIdentifier=$RANDOM*$RANDOM"
location="eastus"
resourceGroup="msdocs-tutorial-rg-$randomIdentifier"
az group create --name $resourceGroup --location $location --output json

$randomIdentifier = (New-Guid).ToString().Substring(0,8)
$location="eastus"
$resourceGroup="msdocs-tutorial-rg-$randomIdentifier"
az group create --name $resourceGroup --location $location --output json

Bash ve PowerShell konsol çıkışı:

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/msdocs-tutorial-rg-000000000",
  "location": "eastus",
  "managedBy": null,
  "name": "msdocs-tutorial-rg-000000000",
  "properties": {
    "provisioningState": "Succeeded"
  },
  "tags": null,
  "type": "Microsoft.Resources/resourceGroups"
}

Ortam değişkenlerini belirleme

Azure CLI, ortak parametre değerlerini yeniden kullanmanıza olanak sağlayan çeşitli seçenekler sunar. Bu varsayılan değerler ortam değişkenlerinde depolanır ve her oturum açma için benzersizdir.

Varsayılan kaynak grubunuzu ayarlayın.

az config set defaults.group=<msdocs-tutorial-rg-0000000>

Aynı anda birden çok ortam değişkeni ayarlayın.

Birçok Azure CLI parametresi bir boşlukla ayrılmış birden çok değer alır. Yapılandırma değerleri bu tür örneklerden biridir. Sonraki örnek, her Azure CLI komutunun .location ve .group parametreleri tarafından --location kullanılan ve --resource-group varsayılanlarını ayarlar.
```
az config set defaults.location=westus2 defaults.group=<msdocs-tutorial-rg-0000000>
```
Varsayılan çıkışınızı ayarlayın.

Azure Cloud Shell'de çalışmayı veya Azure CLI'yi yerel olarak yüklemeyi seçtiğinizde, varsayılan çıkış otomatik olarak olarak jsonayarlanır. Ancak bu, anlaşılması ve ayarlanması gereken en önemli varsayılan değerlerden biridir. Çıkış, konsolunuzda görünenleri ve günlük dosyanıza yazılanları belirler. Anahtarları, parolaları ve gizli dizileri döndüren kaynakları oluştururken her zaman çıkışını none kullanın.
```
az config set core.output=none
```
Bu öğreticide gizli dizilerle çalışmıyoruz. Bu öğreticide her başvuru komutunun döndürülen çıkışını görebilmek için json varsayılanı geri olarak ayarlayın.
```
az config set core.output=json
```

kullanmayı az initöğrenin.

Azure CLI,ortamınızı yapılandırma konusunda size yol gösteren bir başvuru komutuna sahiptir. Konsolunuza yazın az init ve Enter tuşuna basın. Sağlanan istemleri izleyin.

az init

az init ile ilgili ilk güzel şey, size tüm geçerli ayarlarınızı vermesidir! Örnek çıktı aşağıda verilmişti:

Your current config settings:

  Output format: JSON 
  [core.output = json]

  Standard error stream (stderr): All events 
  [core.only_show_errors = false]

  Error output: Show recommendations 
  [core.error_recommendation = on]

  Syntax highlighting: On 
  [core.no_color = false]

  Progress Bar: On 
  [core.disable_progress_bar = false]


Select an option by typing it's number

  [1] Optimize for interaction
      These settings improve the output legibility and optimize for human interaction

  [2] Optimize for automation
      These settings optimize for machine efficiency

  [3] Customize settings
      A walk through to customize common configurations

  [4] Exit (default)
      Return to the command prompt

? Your selection:

Yapılandırma dosyanızı bulun ve okuyun.

"Güven ama doğrula" düşünce yapısı altında çalışıyorsanız, yapılandırma dosyalarınızın nerede depolandığını ve bunların ne içerdiğini bilmek istersiniz. Yapılandırma dosyasının kendisi şu konumdadır: $AZURE_CONFIG_DIR/config. Varsayılan AZURE_CONFIG_DIR değeri Linux ve macOS’ta $HOME/.azure, Windows’da %USERPROFILE%\.azure şeklindedir. Yapılandırma dosyanızı hemen bulun ve ne içerdiğine bakın.

Daha fazla ayrıntı alın

Bu öğretici adımında ele alınan konulardan biri hakkında daha fazla ayrıntı istiyor musunuz? Daha fazla bilgi edinmek için bu tablodaki bağlantıları kullanın.

Konu	Daha fazla bilgi edinin
Ortamlar	Doğru Azure komut satırı aracını seçme
Oturum açma seçenekleri	Azure CLI ile oturum açma
Terimler	Azure CLI terminolojisi ve destek düzeyleri
Abonelikler	Azure CLI kullanarak abonelikleri yönetme
Kaynak grupları	Azure CLI kullanarak kaynak gruplarını yönetme
Yapılandırmalar	Azure CLI'yi yapılandırma
Azure rolleri	Azure rolleri, Microsoft Entra rolleri ve klasik abonelik yöneticisi rolleri

Sonraki Adım

Ortamınızı yapılandırmayı öğrendiğinize göre Bash, PowerShell ve Cmd arasındaki betik oluşturma farklarını öğrenmek için sonraki adıma geçin.

Bash, PowerShell ve Cmd'de Azure CLI söz dizimi farklarını öğrenin

Aracılığıyla paylaş

Ortamınızı Azure CLI’ye hazırlama

Azure CLI'yi yükleme

Etkin aboneliğinizi bulma ve değiştirme

Kaynak grupları hakkında bilgi edinin

Kaynak grubu oluşturma

Rastgele kimlik içeren bir kaynak grubu oluşturma

Ortam değişkenlerini belirleme

Daha fazla ayrıntı alın

Sonraki Adım

Geri Bildirim

Ek kaynaklar

Aracılığıyla paylaş

Ortamınızı Azure CLI’ye hazırlama

Azure CLI'yi yükleme

Azure CLI kullanarak Azure'da oturum açma

Etkin aboneliğinizi bulma ve değiştirme

Kaynak grupları hakkında bilgi edinin

Kaynak grubu oluşturma

Rastgele kimlik içeren bir kaynak grubu oluşturma

Ortam değişkenlerini belirleme

Daha fazla ayrıntı alın

Sonraki Adım

Geri Bildirim

Ek kaynaklar