Quickstart: Een containerregister maken met behulp van een Bicep-bestand

In deze quickstart ziet u hoe u een Azure Container Registry-exemplaar maakt met behulp van een Bicep-bestand.

Bicep is een domeinspecifieke taal (DSL) die declaratieve syntaxis gebruikt om Azure-resources te implementeren. Deze taal voorziet in een beknopte syntaxis, betrouwbare typeveiligheid en ondersteuning voor hergebruik van code. Bicep biedt de beste ontwerpervaring voor uw infrastructuur als code-oplossingen in Azure.

Vereisten

Als u geen Azure-abonnement hebt, maakt u een gratis account voordat u begint.

Het Bicep-bestand controleren

Gebruik Visual Studio Code of uw favoriete editor om een bestand te maken met de volgende inhoud en geef het main.bicep een naam:

@minLength(5)
@maxLength(50)
@description('Provide a globally unique name of your Azure Container Registry')
param acrName string = 'acr${uniqueString(resourceGroup().id)}'

@description('Provide a location for the registry.')
param location string = resourceGroup().location

@description('Provide a tier of your Azure Container Registry.')
param acrSku string = 'Basic'

resource acrResource 'Microsoft.ContainerRegistry/registries@2023-01-01-preview' = {
  name: acrName
  location: location
  sku: {
    name: acrSku
  }
  properties: {
    adminUserEnabled: false
  }
}

@description('Output the login server property for later use')
output loginServer string = acrResource.properties.loginServer

De volgende resource is gedefinieerd in het Bicep-bestand:

• Microsoft.ContainerRegistry/registries: een Azure Container Registry maken

Meer voorbeelden van Azure Container Registry-exemplaren vindt u in de galerie met quickstart-sjablonen.

Het Bicep-bestand implementeren

Als u het bestand wilt implementeren dat u hebt gemaakt, opent u PowerShell of Azure CLI. Als u de geïntegreerde Visual Studio Code-terminal wilt gebruiken, selecteert u de ctrl + ` toetsencombinatie. Wijzig de huidige map in de locatie waar het Bicep-bestand zich bevindt.

CLI

az group create --name myContainerRegRG --location centralus

az deployment group create --resource-group myContainerRegRG --template-file main.bicep --parameters acrName={your-unique-name}

Powershell

New-AzResourceGroup -Name myContainerRegRG -Location centralus

New-AzResourceGroupDeployment -ResourceGroupName myContainerRegRG -TemplateFile ./main.bicep -acrName "{your-unique-name}"

Notitie

Vervang {your-unique-name}, inclusief de accolades, door een unieke containerregisternaam.

Wanneer de implementatie is voltooid, ziet u een bericht waarin wordt aangegeven dat de implementatie is voltooid.

Geïmplementeerde resources bekijken

Gebruik de Azure-portal of een hulpprogramma zoals de Azure CLI om de eigenschappen van het containerregister te controleren.

1. Zoek in de portal naar containerregisters en selecteer het containerregister dat u hebt gemaakt.

2. Op de pagina Overzicht noteert u de aanmeldingsserver van het register. Gebruik deze URI wanneer u Docker gebruikt om installatiekopieën te taggen en te pushen naar het register. Zie Uw eerste installatiekopie pushen met de Docker-CLI voor meer informatie.

   

Resources opschonen

Wanneer u de resource niet meer nodig hebt, verwijdert u de resourcegroep en het register. Hiertoe gaat u naar de Azure-portal, selecteert u de resourcegroep die het register bevat en selecteert u vervolgens Resourcegroep verwijderen.

Volgende stappen

In deze quickstart hebt u een Azure Container Registry gemaakt met een Bicep-bestand. Ga verder met de zelfstudies voor Azure Container Registry om meer te leren over ACR.

Azure Container Registry-zelfstudies

Voor een stapsgewijze zelfstudie die u begeleidt bij het maken van een Bicep-bestand, raadpleegt u:

Quickstart: Bicep-bestanden maken met Visual Studio Code