Použití Azure Pipelines k vytváření a nabízení imagí kontejnerů do registrů

Azure DevOps Services

Tento článek vás provede vytvořením pipeline pro sestavení a nahrání Docker image do služby Azure Container Registry nebo Docker Hubu.

Požadavky

Produkt	Požadavky
Azure DevOps	– projekt Azure DevOps . oprávnění - :     - Chcete-li udělit přístup ke všem kanálům v projektu: Musíte být členem skupiny Project Administrators.     - Chcete-li vytvořit připojení služby: Musíte mít roli Správce nebo Creator pro připojení služby . – Pokud používáte agenta v místním prostředí, ujistěte se, že je nainstalovaný Docker a modul Dockeru běží se zvýšenými oprávněními. Agenti hostovaní Microsoftem mají předinstalovaný Docker.
GitHub	– účet GitHubu. – Úložiště GitHubu se souborem Dockerfile. Pokud nemáte vlastní projekt, použijte ukázkové úložiště. – připojení ke službě GitHub k autorizaci Azure Pipelines.
Azurová ( Azure)	– předplatné Azure. – Azure Container Registry.

Produkt	Požadavky
Azure DevOps	– projekt Azure DevOps . oprávnění - :     - Chcete-li udělit přístup ke všem kanálům v projektu: Musíte být členem skupiny Project Administrators.     - Chcete-li vytvořit připojení služby: Musíte mít roli Správce nebo Creator pro připojení služby . – Pokud používáte agenta v místním prostředí, ujistěte se, že je nainstalovaný Docker a modul Dockeru běží se zvýšenými oprávněními. Agenti hostovaní Microsoftem mají předinstalovaný Docker.
GitHub	– účet GitHubu. – Úložiště GitHubu se souborem Dockerfile. Pokud nemáte vlastní projekt, použijte ukázkové úložiště. – připojení ke službě GitHub k autorizaci Azure Pipelines.
Centrum Dockeru	– účet Docker Hub. – Úložiště obrázků Docker Hub.

Vytvoření spojení registru služby Dockeru

Před nasdílením imagí kontejneru do registru je potřeba vytvořit připojení služby v Azure DevOps. Toto připojení služby ukládá přihlašovací údaje potřebné k bezpečnému ověření v registru kontejneru. Další informace naleznete v části připojení služby Docker Registry.

1. V projektu Azure DevOps vyberte Nastavení projektu>Připojení služby.

   

2. Vyberte Nové připojení služby a Docker registr.

   

3. Vyberte Docker Hub a zadejte následující informace:

   Pole	Popis
   ID Dockeru	Zadejte id Dockeru.
   Docker heslo	Zadejte heslo Dockeru.
   název připojení služby	Zadejte název připojení služby.
   Udělení oprávnění k přístupu všem kanálům	Tuto možnost vyberte, pokud chcete udělit přístup ke všem kanálům.

   

4. Vyberte Ověřit a uložit.

Vytvoření kanálu pro sestavení a nasdílení image Dockeru

Úloha Docker@2 slouží k sestavení a nasdílení image do registru kontejneru. Úloha Docker@2 je navržená tak, aby zjednodušila proces sestavování, nabízení a správy imagí Dockeru v rámci azure Pipelines. Tato úloha podporuje širokou škálu příkazů Dockeru, včetně sestavení, nasdílení změn, přihlášení, odhlášení, spuštění, zastavení a spuštění.

Pomocí následujícího postupu vytvořte kanál YAML, který používá úlohu Docker@2 k sestavení a nasdílení image.

1. V projektu Azure DevOps vyberte Pipelines a New pipeline.

2. Jako umístění zdrojového kódu vyberte GitHubu a vyberte úložiště.

   • Pokud jste přesměrováni na GitHub, abyste se mohli přihlásit, zadejte svoje přihlašovací údaje GitHubu.
   • Pokud jste přesměrováni na GitHub, abyste nainstalovali aplikaci Azure Pipelines, vyberte Schválit a nainstalovat.

3. Vyberte úložiště.

4. Výběrem šablony úvodního kanálu vytvořte základní konfiguraci kanálu.

5. Obsah azure-pipelines.yml nahraďte následujícím kódem:

   
   trigger:
   - main
   
   pool:
     vmImage: 'ubuntu-latest' 
   
   variables:
     repositoryName: '<target repository name>' 
   
   steps:
   - task: Docker@2
     inputs:
       containerRegistry: '<docker registry service connection>'
       repository: $(repositoryName)
       command: 'buildAndPush'
       Dockerfile: '**/Dockerfile'
   
   

6. Upravte soubor YAML kanálu následujícím způsobem:

   • Nahraďte <target repository name> názvem úložiště v registru kontejneru, do kterého chcete vložit image.
   • Nahraďte <docker registry service connection> názvem dříve vytvořeného připojení služby registru Dockeru.

7. Až budete hotovi, vyberte Uložit a spustit>Uložit a spustit.

8. Vyberte Úloha, abyste zobrazili protokoly a ověřili úspěšné spuštění kanálu.

Vytvořte potrubí pomocí klasického editoru

1. V projektu Azure DevOps vyberte Kanály a nový kanál

2. Vyberte Klasický editor na stránce Kde je váš kód?.

3. Na stránce Vyberte zdroj vyberte GitHub.

4. Zvolte úložiště a vyberte Pokračovat.

5. Na stránce Vyberte šablonu zvolte Prázdné potrubí a Použít.

6. Vyberte nejnovější ubuntu pro Specifikaci agenta.

   

Přidejte úlohu Docker@2 do pipeline

Pokud chcete sestavit a odeslat image do registru kontejneru, přidejte úlohu Docker@2 do kanálu.

1. Přidejte úkol do úlohy agenta 1.

   

2. Vyberte úlohu Docker a Přidat .

3. Vyberte úlohu buildAndPush.

4. Pro Container Registryvyberte připojení služby, které jste vytvořili dříve. Pokud ho nemáte, vyberte +Nový a vytvořte nové připojení ke službě Docker Hub.

   

Spuštění kanálu

1. Vyberte Uložit a zařadit do fronty>Uložit a zařadit do fronty.
2. Na stránce Spustit potrubí vyberte Uložit a spustit.
3. Vyberte úkol, abyste zobrazili protokoly a ověřili, že pipeline byla úspěšně spuštěna.

1. Přejděte do projektu Azure DevOps a v nabídce vlevo vyberte Pipelines.

2. Vyberte Nové potrubí.

3. Jako umístění zdrojového kódu vyberte GitHubu a vyberte úložiště.

   • Pokud jste přesměrováni na GitHub, abyste se mohli přihlásit, zadejte svoje přihlašovací údaje GitHubu.
   • Pokud jste přesměrováni na GitHub, abyste nainstalovali aplikaci Azure Pipelines, vyberte Schválit a nainstalovat.

4. Vyberte Dockeru – Sestavte a nasdílejte image do šablony služby Azure Container Registry.

5. Vyberte své předplatné Azure a Pokračovat.

6. Vyberte službu Container Registry a pak vyberte Ověřit a nakonfigurovat.

   Příklad kanálu YAML:

   # Docker
   # Build and push an image to Azure Container Registry
   # https://docs.microsoft.com/azure/devops/pipelines/languages/docker
   
   trigger:
   - main
   
   resources:
   - repo: self
   
   variables:
     # Container registry service connection established during pipeline creation
     dockerRegistryServiceConnection: '7f9dc28e-5551-43ee-891f-33bf61a995de'
     imageRepository: 'usernamepipelinesjavascriptdocker'
     containerRegistry: 'repoistoryname.azurecr.io'
     dockerfilePath: '$(Build.SourcesDirectory)/app/Dockerfile'
     tag: '$(Build.BuildId)'
   
     # Agent VM image name
     vmImageName: 'ubuntu-latest'
   
   stages:
   - stage: Build
     displayName: Build and push stage
     jobs:
     - job: Build
       displayName: Build
       pool:
         vmImage: $(vmImageName)
       steps:
       - task: Docker@2
         displayName: Build and push an image to container registry
         inputs:
           command: buildAndPush
           repository: $(imageRepository)
           dockerfile: $(dockerfilePath)
           containerRegistry: $(dockerRegistryServiceConnection)
           tags: |
             $(tag)
   
   

7. Vyberte Uložit a spusťte a Uložit a spusťte znovu.

8. Vyberte Úlohu, abyste zobrazili protokoly a ověřili úspěch spuštění pipeline.

Šablona Dockeru vytvoří připojení služby ke službě Azure Container Registry a pomocí úlohy Docker@2 sestaví a odešle image Dockeru do registru.

Úloha Docker@2 je navržená tak, aby zjednodušila proces sestavování, nabízení a správy imagí Dockeru v rámci azure Pipelines. Tato úloha podporuje širokou škálu příkazů Dockeru, včetně sestavení, nasdílení změn, přihlášení, odhlášení, spuštění, zastavení a spuštění.

Vytvořte pipeline pomocí klasického editoru

1. V projektu Azure DevOps vyberte Kanály a Nový kanál.

2. Vyberte možnost Použít klasický editor na stránce Kde máte kód?.

3. Na stránce Vyberte zdroj vyberte GitHub.

4. Zvolte úložiště a vyberte Pokračovat.

5. Na stránce vyberte šablonu vyberte Prázdné potrubí a Použít.

6. Vyberte nejnovější ubuntu pro specifikace agenta.

   

Přidejte úlohu Docker@2 do pipeline

Přidejte do pipeline Docker@2 úlohu pro sestavení a odeslání obrazu do registru kontejneru.

1. Přidejte úlohu k práci agenta , úloha 1.

   

2. Vyberte úlohu Docker a Přidejte.

3. Vyberte úlohu buildAndPush.

4. Vytvořte připojení služby výběrem možnosti +Nový.

   

5. Vyplňte následující pole:

   Pole	Popis
   předplatného	Vyberte své předplatné Azure.
   registru kontejnerů Azure	Vyberte registr kontejneru Azure.
   název připojení služby	Zadejte název připojení služby.
   Udělení oprávnění k přístupu všem kanálům	Tuto možnost vyberte, pokud chcete udělit přístup ke všem kanálům.

   

6. Vyberte Uložit.

Spuštění kanálu

1. Vyberte Uložit a zařadit do fronty>Uložit a zařadit do fronty.
2. Na stránce Spustit kanál vyberte Uložit a spustit.
3. Vyberte Úloha, abyste zobrazili protokoly a ověřili úspěšné spuštění kanálu.

Při použití agentů v místním prostředí se ujistěte, že je Docker nainstalovaný na hostiteli agenta a že modul/démon Dockeru běží se zvýšenými oprávněními.

Související články

• Sestavení obrazu kontejneru
• důvěryhodnosti obsahu Dockeru