Een installatiekopie pushen

Azure DevOps Services

Gebruik Azure Pipelines om uw installatiekopieën naar een containerregister te pushen, zoals Azure Container Registry, Docker Hub of Google Container Registry. Azure Container Registry is een beheerde registerservice op basis van de opensource Docker Registry 2.0.

Zie Docker-installatiekopieën bouwen en pushen naar Azure Container Registry voor een zelfstudie over het bouwen en pushen van installatiekopieën naar een containerregister.

Zie Containerinstallatiekopieën bouwen om apps te implementeren voor meer informatie over het bouwen van een containerinstallatiekopieën voor implementatie met Azure Pipelines.

Over de Docker-taak

U gebruikt de Docker@2 taak om Docker-installatiekopieën, aanmelding of afmelding, containers te starten of stoppen, of een Docker-opdracht uit te voeren.

De taak maakt gebruik van een Docker-registerserviceverbinding voor Azure Container Registry om u aan te melden en naar een containerregister te pushen. Het proces voor het maken van een Docker-registerserviceverbinding verschilt afhankelijk van uw register.

In de Docker-registerserviceverbinding worden referenties opgeslagen in het containerregister voordat de installatiekopieën worden gepusht. U kunt ook rechtstreeks verwijzen naar serviceverbindingen in Docker zonder een extra scripttaak.

Een Docker-serviceverbinding maken

U moet een ander proces volgen om een serviceverbinding te maken voor Azure Container Registry, Docker Hub en Google Container Registry.

Azure Container Registry

Met de optie Azure Container Registry worden het abonnement (gekoppeld aan de Microsoft Entra-identiteit van de gebruiker die is aangemeld bij Azure DevOps) en het containerregister binnen het abonnement gebruikt om de serviceverbinding te maken.

Notitie

Deze serviceverbindingsmethode maakt gebruik van een service-principal en geen workloadidentiteitsfederatie voor verificatie. Zie Serviceverbindingen beheren voor Azure Container Registry voor meer informatie over het gebruik van workloadidentiteit in plaats daarvan met Azure Container Registry.

Wanneer u een nieuwe pijplijn maakt voor een opslagplaats die een Dockerfile bevat, detecteert Azure Pipelines Dockerfile in de opslagplaats. Als u dit proces wilt starten, maakt u een nieuwe pijplijn en selecteert u de opslagplaats met uw Dockerfile.

1. Selecteer op het tabblad Configureren de Docker - Een installatiekopieën bouwen en pushen naar de Azure Container Registry-taak .

   

2. Selecteer uw Azure-abonnement en selecteer vervolgens Doorgaan.

3. Selecteer uw containerregister in de vervolgkeuzelijst en geef vervolgens een installatiekopieënnaam op voor de containerinstallatiekopieën.

4. Selecteer Valideren en configureren wanneer u klaar bent.

   

   Wanneer Azure Pipelines uw pijplijn maakt, gebeurt het volgende:

   • Maak een Docker-registerserviceverbinding om uw pijplijn in staat te stellen installatiekopieën naar uw containerregister te pushen.

   • Genereer een azure-pipelines.yml-bestand , waarmee uw pijplijn wordt gedefinieerd.

Zie het document Build and Push to Azure Container Registry voor een gedetailleerder overzicht.

Docker Hub

Kies de optie Docker Hub onder de docker-registerserviceverbinding en geef uw gebruikersnaam en wachtwoord op om een Docker-serviceverbinding te maken.

Google Container Registry

Een Docker-serviceverbinding maken die is gekoppeld aan Google Container Registry:

1. Open uw project in de GCP-console en open vervolgens Cloud Shell

2. Als u tijd wilt besparen bij het typen van de project-id en de zoneopties voor compute-engine, stelt u standaardconfiguratiewaarden in door de volgende opdrachten uit te voeren:

   gcloud config set project [PROJECT_NAME]
   gcloud config set compute/zone [ZONE]
   

3. Vervang [PROJECT_NAME] door de naam van uw GCP-project en vervang deze door [ZONE] de naam van de zone die u gaat gebruiken voor het maken van resources. Als u niet zeker weet welke zone u moet kiezen, gebruikt u us-central1-a. Voorbeeld:

   gcloud config set project azure-pipelines-test-project-12345
   gcloud config set compute/zone us-central1-a
   

4. Schakel de Container Registry-API in voor uw project:

   gcloud services enable containerregistry.googleapis.com
   

5. Maak een serviceaccount voor Azure Pipelines om Docker-installatiekopieën te publiceren:

   gcloud iam service-accounts create azure-pipelines-publisher --display-name "Azure Pipelines Publisher"
   

6. Wijs de IAM-rol opslagbeheerder toe aan het serviceaccount:

   PROJECT_NUMBER=$(gcloud projects describe \
   $(gcloud config get-value core/project) \
   --format='value(projectNumber)')
   
   AZURE_PIPELINES_PUBLISHER=$(gcloud iam service-accounts list \
       --filter="displayName:Azure Pipelines Publisher" \
       --format='value(email)')
   
   gcloud projects add-iam-policy-binding \
       $(gcloud config get-value core/project) \
       --member serviceAccount:$AZURE_PIPELINES_PUBLISHER \
       --role roles/storage.admin
   

7. Een serviceaccountsleutel genereren:

   gcloud iam service-accounts keys create \
   azure-pipelines-publisher.json --iam-account $AZURE_PIPELINES_PUBLISHER
   
   tr -d '\n' < azure-pipelines-publisher.json > azure-pipelines-publisher-oneline.json
   

   Start Code-editor door op de knop in de rechterbovenhoek van Cloud Shell te klikken:

   

8. Open het bestand named azure-pipelines-publisher-oneline.json. U hebt de inhoud van dit bestand nodig in een van de volgende stappen:

9. Selecteer projectinstellingen in uw Azure DevOps-organisatie en selecteer vervolgens Pijplijnen -> Serviceverbindingen.

10. Selecteer Nieuwe serviceverbinding en kies Docker Registry

11. Voer in het dialoogvenster waarden in voor de volgende velden:

    • Docker Registry: https://gcr.io/[PROJECT-ID], waar [PROJECT-ID] is de naam van uw GCP-project.
    • Docker-id: _json_key
    • Docker-wachtwoord: plak de inhoud van azure-pipelines-publisher-oneline.json
    • Serviceverbindingsnaam: gcrServiceConnection

12. Selecteer Opslaan om de serviceverbinding te maken