練習 - 建立登錄

4 分鐘

注意

當您第一次啟動沙箱並接受條款時，您的 Microsoft 帳戶會與名為「Microsoft Learn 沙箱」的新 Azure 目錄建立關聯。系統也會將您新增至名為「指引訂用帳戶」的特殊訂用帳戶。

您必須先為組織建立登錄，才能發佈 CDN 和網站的 Bicep 模組。然後將共用模組發佈至登錄。接著，其他小組可以建立包含共用模組的部署。

在本練習中，您將會：

為您的玩具公司部署要使用的新私人登錄。
連線至登錄，以確認已成功建立。

若要部署至 Azure，您必須從 Visual Studio Code 終端登入您的 Azure 帳戶。請確定您已安裝 Azure CLI，並使用您用來啟動沙箱的相同帳戶登入。

在 [終端機] 功能表上，選取 [新增終端機]。終端機視窗通常隨即在畫面的下半部開啟。
如果終端視窗右側顯示的殼層為 [bash]，則正確的殼層隨即開啟，而您可以跳至下一節。
如果Bash以外的殼層出現，請選取殼層下拉式箭號，然後選取 [Azure Cloud Shell][Bash]。
在終端機殼層清單中，選取 [bash]。
在終端機中，前往您儲存範本的目錄。例如，若將範本儲存於 templates 資料夾，則可使用此命令：
```
cd templates
```

安裝 Bicep

執行以下命令，確保您有最新版本 Bicep：

az bicep install && az bicep upgrade

在 Visual Studio Code 終端中，執行下列命令以登入 Azure：
```
az login
```
在開啟的瀏覽器中，登入您的 Azure 帳戶。

Visual Studio Code 終端機會顯示與此帳戶相關聯的訂用帳戶清單。
將您在此工作階段中執行的所有 Azure CLI 命令，設定為預設的訂用帳戶。
```
az account set --subscription "Concierge Subscription"
```
注意

如果您最近使用多個沙箱，則終端機可能會顯示多個「指引訂用帳戶」執行個體。在此情況下，請使用接下來的兩個步驟來將其設定為預設訂用帳戶。如果上述命令成功，且只列出一個「指引訂用帳戶」，則請略過接下來的兩個步驟。

取得指引訂用帳戶識別碼。

 az account list \
   --refresh \
   --query "[?contains(name, 'Concierge Subscription')].id" \
   --output table

使用訂用帳戶識別碼設定預設訂用帳戶。將 {your subscription ID} 取代為最新的指引訂用帳戶識別碼。
```
az account set --subscription {your subscription ID}
```

設定預設資源群組

使用 Azure CLI 時，您可以設定預設的資源群組，並省略本練習中其餘的 Azure CLI 命令參數。將預設值設定為在沙箱環境中為您建立的資源群組。

az configure --defaults group="<rgn>[sandbox resource group name]</rgn>"

若要部署至 Azure，您必須從 Visual Studio Code 終端登入您的 Azure 帳戶。請確定您已安裝 Azure PowerShell，並登入啟動沙箱的相同帳戶。

在 [終端機] 功能表上，選取 [新增終端機]。終端機視窗通常隨即在畫面的下半部開啟。
如果終端視窗右側顯示的殼層是 powershell 或 pwsh，則已開啟正確的殼層，而您可以跳至下一節。
如果出現 powershell 或 pwsh 以外的殼層，則請選取殼層下拉式清單箭號，然後選取 [PowerShell]。
在終端機殼層清單中，選取 [powershell] 或 [pwsh]。
在終端機中，前往您儲存範本的目錄。例如，若將範本儲存在 templates 資料夾，則可使用此命令：
```
Set-Location -Path templates
```

安裝 Bicep CLI

若要從 Azure PowerShell 使用 Bicep，請安裝 Bicep CLI。

在 Visual Studio Code 終端中，執行下列命令：
```
Connect-AzAccount
```
瀏覽器隨即開啟，讓您可以登入您的 Azure 帳戶。
登入 Azure 之後，您會在終端機中看到與此帳戶相關聯的訂用帳戶清單。

如果您已啟動沙箱，則會顯示名為「指引訂用帳戶」的訂用帳戶。請在接下來的練習中使用此訂用帳戶。
將您在此工作階段中執行的所有 Azure PowerShell 命令，設定為預設的訂用帳戶。
```
$context = Get-AzSubscription -SubscriptionName 'Concierge Subscription'
Set-AzContext $context
```
注意

如果您最近使用多個沙箱，則終端機可能會顯示多個「指引訂用帳戶」執行個體。在此情況下，請使用接下來的兩個步驟來將其設定為預設訂用帳戶。如果上述命令成功，且只列出一個「指引訂用帳戶」，則請略過接下來的兩個步驟。
取得訂用帳戶識別碼。執行下列命令會列出您的訂用帳戶與其識別碼。尋找 Concierge Subscription，然後複製第二個資料行的識別碼。其看起來像 cf49fbbc-217c-4eb6-9eb5-a6a6c68295a0。
```
Get-AzSubscription
```
將您使用中的訂用帳戶變更為「指引訂用帳戶」。請務必將 {Your subscription ID} 取代為您複製的訂用帳戶。
```
$context = Get-AzSubscription -SubscriptionId {Your subscription ID}
Set-AzContext $context
```

設定預設資源群組

您可以設定預設資源群組，並省略本練習中其餘的 Azure PowerShell 命令參數。將此預設值設定為在沙箱環境中為您建立的資源群組。

Set-AzDefault -ResourceGroupName <rgn>[sandbox resource group name]</rgn>

建立容器登錄

在這裡，您會建立新的登錄來儲存及共用 Bicep 模組。此範例使用 Azure Container Registry。

選取容器登錄的唯一名稱。此名稱在 Azure 中必須是全域唯一的。選擇長度為 5 到 50 個字元且包含字母和數字的名稱。您在後續步驟中使用該名稱。
在 Visual Studio Code 終端中執行此命令，以建立容器登錄。將 YOUR_CONTAINER_REGISTRY_NAME 預留位置取代為您在上一個步驟中選取的名稱。
```
az acr create \
  --name YOUR_CONTAINER_REGISTRY_NAME \
  --sku Basic \
  --location westus
```

提示

您也可以使用 Bicep 來建立容器登錄。在此範例中，我們會使用 Azure CLI 來簡化。

選取容器登錄的唯一名稱。此名稱在 Azure 中必須是全域唯一的。選擇長度為 5 到 50 個字元且包含字母和數字的名稱。您在後續步驟中使用該名稱。
在 Visual Studio Code 終端中執行此命令，以建立容器登錄。將 YOUR_CONTAINER_REGISTRY_NAME 預留位置取代為您在上一個步驟中選取的名稱。
```
New-AzContainerRegistry `
  -Name YOUR_CONTAINER_REGISTRY_NAME `
  -Sku Basic `
  -Location westus
```

提示

您也可以使用 Bicep 來建立容器登錄。在此範例中，我們會使用 Azure PowerShell Cmdlet 來簡化。

列出登錄中的模組

既然您已建立登錄，您就可以連線至該登錄，以確認其運作正常。

執行此命令以列出登錄中的模組。將 YOUR_CONTAINER_REGISTRY_NAME 預留位置取代為您稍早選取的名稱。
```
az acr repository list \
  --name YOUR_CONTAINER_REGISTRY_NAME
```
請注意，您未指定要連線至容器登錄的任何認證。 Azure CLI 會使用您用來登入 Azure CLI 的相同認證。因為您已建立容器登錄，所以您可以存取容器登錄。
Azure CLI 命令會傳回一個清單，其中不包含任何結果：
```
[]
```
因為您尚未發佈任何模組，所以看不到任何結果。您將在下一個單元中深入了解發佈模組。

執行此命令以列出登錄中的模組。將 YOUR_CONTAINER_REGISTRY_NAME 預留位置取代為您稍早選取的名稱。
```
Get-AzContainerRegistryRepository `
  -RegistryName YOUR_CONTAINER_REGISTRY_NAME
```
請注意，您未指定要連線至容器登錄的任何認證。 Azure PowerShell 會使用您用來登入 Azure PowerShell Cmdlet 的相同認證。因為您已建立容器登錄，所以您可以存取容器登錄。
Azure PowerShell Cmdlet 不會顯示任何輸出。

因為您尚未發佈任何模組，所以看不到任何結果。您在下一個單元中深入了解發佈模組。

練習 - 建立登錄

安裝 Bicep

登入 Azure

設定預設資源群組

安裝 Bicep CLI

使用 Azure PowerShell 登入 Azure

設定預設資源群組

建立容器登錄

列出登錄中的模組

意見反應