Ortamınızı Azure CLI için hazırlama

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 Azure ücretsiz hesabı oluşturun.

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

Azure CLI yükleme

Ortamınızı seçerek başlayın.

  • Azure Cloud Shell'de Bash ortamını kullanmak için her Azure CLI kod bloğunun sağ üst köşesindeki Open Cloud Shell düğmesine tıklayın.

  • Azure CLI başvuru komutlarını yerelde çalıştırmayı tercih ediyorsanız, Azure CLI’yi yükleyin.

Azure CLI geçerli sürümü 2.89.1'dir. 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 kullanarak Azure oturum açın

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

  1. az login komutunu çalıştırın.

    az login
    

    Azure CLI varsayılan tarayıcınızı açabiliyorsa, authorization code flow 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, ile az login --use-device-codecihaz kodu akışını zorlayabilirsiniz.

  2. Tarayıcıda hesabınızın kimlik bilgileriyle oturum açın.

Etkin aboneliğinizi bulma ve değiştirme

Azure CLI 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>

az account show komutu için 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ı için bir kapsayıcıdır. Kaynak grubu oluşturmak için aboneliğinizde contributor izinlerine veya daha yüksek bir yetkiye sahip olmanız gerekir.

Bir kaynak grubu oluşturun

  1. 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>
    
  2. 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
    
  3. 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 kaldırılmasını beklemenize gerek 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 kodu kopyalayın.

let "randomIdentifier=$RANDOM*$RANDOM"
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.

  1. Varsayılan kaynak grubunuzu ayarlayın.

    az config set defaults.group=<msdocs-tutorial-rg-0000000>
    
  2. 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 kullanılan --location ve --resource-group varsayılanlarını ayarlar.

    az config set defaults.location=westus2 defaults.group=<msdocs-tutorial-rg-0000000>
    
  3. Varsayılan çıkışınızı ayarlayın.

    Azure Cloud Shell çalışmayı veya Azure CLI yerel olarak yüklemeyi seçtiğinizde, varsayılan çıkış otomatik olarak json olarak ayarlanır. Ancak bu ayar, anlaşılması ve ayarlanması gereken en önemli varsayılan ayarlardan biridir. Çıkış, konsolunuzda görünenleri ve günlük dosyanıza yazılanları belirler. Her zaman anahtarları, parolaları ve gizli bilgileri döndüren kaynakları oluştururken çıkış olarak none kullanın.

    az config set core.output=none
    

    Bu öğreticide gizli bilgilerle çalışmıyoruz. Bu öğreticide her başvuru komutunun çıktısını görebilmek için varsayılanı json başlangıç değerine geri ayarlayın.

    az config set core.output=json
    
  4. az init kullanmayı öğrenin.

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

    az init
    

    az init'in önemli bir yönü, tüm geçerli ayarlarınızı görüntülemesidir. Çıktının bir örneği 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 its 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: 
    
  5. 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. AZURE_CONFIG_DIR varsayılan değeri Linux ve macOS üzerinde $HOME/.azure ve Windows üzerinde %USERPROFILE%\.azure'dir. Yapılandırma dosyanızı bulun ve içeriğini gözden geçirin.

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
Ortam Doğru Azure komut satırı aracını seçin
Oturum açma seçenekleri Azure CLI ile oturum açın
Şartlar Azure CLI terminoloji ve destek düzeyleri
Abonelik Azure CLI
Kaynak grupları Azure CLI
Yapılandırmalar Azure CLI'yi yapılandırın
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.exearasındaki betik oluşturma farklarını anlamak için sonraki adıma geçin.