Bouwen en implementeren naar Azure Kubernetes Service met Azure Pipelines

Artikel
10/24/2023

Azure DevOps Services

Azure Pipelines gebruiken om automatisch te implementeren in Azure Kubernetes Service (AKS). Met Azure Pipelines kunt u met behulp van Azure DevOps bouwen, testen en implementeren met continue integratie (CI) en continue levering (CD).

In dit artikel leert u hoe u een pijplijn maakt die uw app continu bouwt en implementeert. Telkens wanneer u de code wijzigt in een opslagplaats die een Dockerfile bevat, worden de installatiekopieën naar uw Azure Container Registry gepusht en worden de manifesten vervolgens geïmplementeerd in uw AKS-cluster.

Vereisten

Een Azure-account met een actief abonnement. Gratis een account maken
Een Azure Resource Manager-serviceverbinding. Maak een Azure Resource Manager-serviceverbinding.
Een GitHub-account. Maak een gratis GitHub-account als u er nog geen hebt.

Code ophalen

Fork de volgende opslagplaats met een voorbeeldtoepassing en een Dockerfile:

https://github.com/MicrosoftDocs/pipelines-javascript-docker

De Azure-resources maken

Meld u aan bij Azure Portal en selecteer vervolgens de knop Cloud Shell in de rechterbovenhoek. Gebruik Azure CLI of PowerShell om een AKS-cluster te maken.

# Create a resource group
az group create --name myapp-rg --location eastus

# Create a container registry
az acr create --resource-group myapp-rg --name mycontainerregistry --sku Basic

# Create a Kubernetes cluster
az aks create \
    --resource-group myapp-rg \
    --name myapp \
    --node-count 1 \
    --enable-addons monitoring \
    --generate-ssh-keys

# Install Azure PowerShell
Install-Module -Name Az -Repository PSGallery -Force

# The Microsoft.OperationsManagement resource provider must be registered. This is a one-time activity per subscription.
Register-AzResourceProvider -ProviderNamespace Microsoft.OperationsManagement

# Create a resource group
New-AzResourceGroup -Name myapp-rg -Location eastus

# Create a container registry
New-AzContainerRegistry -ResourceGroupName myapp-rg -Name myContainerRegistry -Sku Basic -Location eastus

# Create a log analytics workspace (or use an existing one)
New-AzOperationalInsightsWorkspace -ResourceGroupName myapp-rg -Name myWorkspace -Location eastus

# Create an AKS cluster with monitoring add-on enabled
$aksParameters = @{ 
  ResourceGroupName = 'myapp-rg'
  Name = 'myapp'
  NodeCount = 1
  AddOnNameToBeEnabled = 'Monitoring'
  GenerateSshKey = $true
  WorkspaceResourceId = '/subscriptions/<subscription-id>/resourceGroups/myapp-rg/providers/Microsoft.OperationalInsights/workspaces/myWorkspace'
}

New-AzAksCluster @aksParameters

Meld u aan bij Azure Pipelines. Nadat u zich hebt aangemeld, gaat uw browser naar https://dev.azure.com/my-organization-name en geeft u uw Azure DevOps-dashboard weer.

Maak binnen uw geselecteerde organisatie een project. Als u geen projecten in uw organisatie hebt, ziet u het scherm Een project maken om aan de slag te gaan . Selecteer anders de knop Project maken in de rechterbovenhoek van het dashboard.

Maak de pijplijn

Verbinding maken en selecteer uw opslagplaats

Meld u aan bij uw Azure DevOps-organisatie en ga naar uw project.
Ga naar Pijplijnen en selecteer vervolgens Nieuwe pijplijn.
Voer de stappen van de wizard uit door eerst GitHub te selecteren als de locatie van uw broncode.
U wordt mogelijk omgeleid naar GitHub om u aan te melden. Voer in dat geval uw GitHub-referenties in.
Wanneer u de lijst met opslagplaatsen ziet, selecteert u de opslagplaats.
U wordt mogelijk omgeleid naar GitHub om de Azure Pipelines-app te installeren. Als dat het zo is, selecteert u Goedkeuren en installeren.
Selecteer Implementeren in Azure Kubernetes Service.
Als u hierom wordt gevraagd, selecteert u het abonnement waarin u het register en cluster hebt gemaakt.
Selecteer het myapp cluster.
Voor naamruimte selecteert u Bestaand en selecteert u vervolgens de standaardwaarde.
Selecteer de naam van het containerregister.
U kunt de naam van de installatiekopieën op de standaardwaarde laten staan.
Stel de servicepoort in op 8080.
Stel het selectievakje Controle-app inschakelen voor pull-aanvragen in om de configuratie van de app te controleren die is gekoppeld aan de pijplijn-YAML automatisch gegenereerd in de volgende stappen.
Selecteer Valideren en configureren.

Terwijl 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.
- Maak een omgeving en een Kubernetes-resource in de omgeving. Voor een cluster met RBAC-functionaliteit maakt de gemaakte Kubernetes-resource impliciet ServiceAccount- en RoleBinding-objecten in het cluster, zodat het gemaakte ServiceAccount geen bewerkingen kan uitvoeren buiten de gekozen naamruimte.
- Genereer een azure-pipelines.yml-bestand , waarmee uw pijplijn wordt gedefinieerd.
- Kubernetes-manifestbestanden genereren. Deze bestanden worden gegenereerd door de templates deployment.yml en service.yml te hydrateren op basis van de selecties die u hebt gemaakt. Wanneer u klaar bent, selecteert u Opslaan en uitvoeren.
Selecteer Opslaan en uitvoeren.
U kunt het doorvoerbericht wijzigen in bijvoorbeeld Pijplijn toevoegen aan onze opslagplaats. Wanneer u klaar bent, selecteert u Opslaan en uitvoeren om de nieuwe pijplijn door te voeren in uw opslagplaats en begint u vervolgens met de eerste uitvoering van de nieuwe pijplijn.

Uw app implementeren bekijken

Terwijl uw pijplijn wordt uitgevoerd, bekijkt u als de buildfase en vervolgens uw implementatiefase, van blauw (actief) naar groen (voltooid). U kunt de fasen en taken selecteren om uw pijplijn in actie te bekijken.

Notitie

Als u een door Microsoft gehoste agent gebruikt, moet u het IP-bereik van de door Microsoft gehoste agent toevoegen aan uw firewall. Haal de wekelijkse lijst met IP-bereiken op uit het wekelijkse JSON-bestand, dat elke woensdag wordt gepubliceerd. De nieuwe IP-bereiken worden de volgende maandag van kracht. Raadpleeg door Microsoft gehoste agents voor meer informatie. Als u de IP-bereiken wilt vinden die vereist zijn voor uw Azure DevOps-organisatie, dan leert u hoe u de mogelijke IP-bereiken voor door Microsoft gehoste agents kunt identificeren.

Nadat de pijplijnuitvoering is voltooid, verkent u wat er is gebeurd en gaat u vervolgens naar de geïmplementeerde app. Vanuit de pijplijnsamenvatting:

Selecteer het tabblad Omgevingen.
Selecteer Omgeving weergeven.
Selecteer het exemplaar van uw app voor de naamruimte waarnaar u hebt geïmplementeerd. Als u de standaardinstellingen hebt gebruikt, is dit de myapp-app in de standaardnaamruimte .
Selecteer het tabblad Services .
Selecteer en kopieer het externe IP-adres naar het klembord.
Open een nieuw browsertabblad of -venster en voer <IP-adres> in:8080.

Als u onze voorbeeld-app bouwt, wordt Hallo wereld weergegeven in uw browser.

Hoe de pijplijn wordt gebouwd

Wanneer u klaar bent met het selecteren van opties en vervolgens verder bent gegaan met het valideren en configureren van de pijplijn die Azure Pipelines voor u heeft gemaakt, gebruikt u de sjabloon Implementeren in Azure Kubernetes Service .

In de buildfase wordt de Docker-taak gebruikt om de installatiekopieën te bouwen en naar Azure Container Registry te pushen.

- stage: Build
  displayName: Build stage
  jobs:  
  - job: Build
    displayName: Build job
    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)

    - task: PublishPipelineArtifact@1
      inputs:
        artifactName: 'manifests'
        path: 'manifests'

De implementatietaak maakt gebruik van de Kubernetes-manifesttaak om de imagePullSecret vereiste kubernetes-clusterknooppunten te maken om de Azure Container Registry-resource op te halen. Manifestbestanden worden vervolgens gebruikt door de Kubernetes-manifesttaak om te implementeren in het Kubernetes-cluster. De manifestbestanden service.yml en deployment.yml, zijn gegenereerd toen u de sjabloon Implementeren in Azure Kubernetes Service gebruikte.

- stage: Deploy
  displayName: Deploy stage
  dependsOn: Build
  jobs:
  - deployment: Deploy
    displayName: Deploy job
    pool:
      vmImage: $(vmImageName)
    environment: 'myenv.aksnamespace' #customize with your environment
    strategy:
      runOnce:
        deploy:
          steps:
          - task: DownloadPipelineArtifact@2
            inputs:
              artifactName: 'manifests'
              downloadPath: '$(System.ArtifactsDirectory)/manifests'

          - task: KubernetesManifest@0
            displayName: Create imagePullSecret
            inputs:
              action: createSecret
              secretName: $(imagePullSecret)
              namespace: $(k8sNamespace)
              dockerRegistryEndpoint: $(dockerRegistryServiceConnection)

          - task: KubernetesManifest@0
            displayName: Deploy to Kubernetes cluster
            inputs:
              action: deploy
              namespace: $(k8sNamespace)
              manifests: |
                $(System.ArtifactsDirectory)/manifests/deployment.yml
                $(System.ArtifactsDirectory)/manifests/service.yml
              imagePullSecrets: |
                $(imagePullSecret)
              containers: |
                $(containerRegistry)/$(imageRepository):$(tag)

Resources opschonen

Wanneer u klaar bent met de resources die u hebt gemaakt, kunt u de volgende opdracht gebruiken om ze te verwijderen:

az group delete --name myapp-rg

Voer in y wanneer u hierom wordt gevraagd.

Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server 2019

Vereisten

Een Azure-account met een actief abonnement. Gratis een account maken
Een Azure Resource Manager-serviceverbinding. Maak een Azure Resource Manager-serviceverbinding.
Een GitHub-account. Maak een gratis GitHub-account als u er nog geen hebt.

Code ophalen

Fork de volgende opslagplaats met een voorbeeldtoepassing en een Dockerfile:

https://github.com/MicrosoftDocs/pipelines-javascript-docker

De Azure-resources maken

Meld u aan bij Azure Portal en selecteer vervolgens de knop Cloud Shell in de rechterbovenhoek. Gebruik Azure CLI of PowerShell om een AKS-cluster te maken.

Een containerregister maken

Azure-CLI
PowerShell

# Create a resource group
az group create --name myapp-rg --location eastus

# Create a container registry
az acr create --resource-group myapp-rg --name mycontainerregistry --sku Basic

# Create a Kubernetes cluster
az aks create \
    --resource-group myapp-rg \
    --name myapp \
    --node-count 1 \
    --enable-addons monitoring \
    --generate-ssh-keys

# Install Azure PowerShell
Install-Module -Name Az -Repository PSGallery -Force

# The Microsoft.OperationsManagement resource provider must be registered. This is a one-time activity per subscription.
Register-AzResourceProvider -ProviderNamespace Microsoft.OperationsManagement

# Create a resource group
New-AzResourceGroup -Name myapp-rg -Location eastus

# Create a container registry
New-AzContainerRegistry -ResourceGroupName myapp-rg -Name myContainerRegistry -Sku Basic -Location eastus

# Create a log analytics workspace (or use an existing one)
New-AzOperationalInsightsWorkspace -ResourceGroupName myapp-rg -Name myWorkspace -Location eastus

# Create an AKS cluster with monitoring add-on enabled
$aksParameters = @{ 
  ResourceGroupName = 'myapp-rg'
  Name = 'myapp'
  NodeCount = 1
  AddOnNameToBeEnabled = 'Monitoring'
  GenerateSshKey = $true
  WorkspaceResourceId = '/subscriptions/<subscription-id>/resourceGroups/myapp-rg/providers/Microsoft.OperationalInsights/workspaces/myWorkspace'
}

New-AzAksCluster @aksParameters

Verificatie configureren

Wanneer u Azure Container Registry (ACR) gebruikt met Azure Kubernetes Service (AKS), moet u een verificatiemechanisme instellen. Dit kan op twee manieren worden bereikt:

AKS toegang verlenen tot ACR. Zie Verifiëren met Azure Container Registry vanuit Azure Kubernetes Service.
Gebruik een pull-geheim voor een Kubernetes-installatiekopie. Een pull-geheim voor installatiekopieën kan worden gemaakt met behulp van de Kubernetes-implementatietaak.

Een release-pijplijn maken

De build-pijplijn die wordt gebruikt om CI in te stellen, heeft al een Docker-installatiekopie gebouwd en naar een Azure Container Registry gepusht. Het pakket heeft ook een Helm-grafiek verpakt en gepubliceerd als artefact. In de release-pijplijn implementeren we de containerinstallatiekopieën als een Helm-toepassing in het AKS-cluster.

Open in Azure Pipelines de samenvatting voor uw build.
Kies in het buildoverzicht het releasepictogram om een nieuwe release-pijplijn te starten.

Als u eerder een release-pijplijn hebt gemaakt die gebruikmaakt van deze buildartefacten, wordt u gevraagd in plaats daarvan een nieuwe release te maken. Ga in dat geval naar de pagina Releases en start daar een nieuwe release-pijplijn door het + pictogram te kiezen.
Selecteer de sjabloon Lege taak .
Open de pagina Taken en selecteer Agenttaak.
Kies ervoor + om een nieuwe taak toe te voegen en een installatietaak voor het Helm-hulpprogramma toe te voegen. Dit zorgt ervoor dat de agent waarop de volgende taken worden uitgevoerd Helm en Kubectl erop zijn geïnstalleerd.
Kies + opnieuw en voeg een pakket toe en implementeer helm-grafieken . Configureer de instellingen voor deze taak als volgt:
- Verbinding maken iontype: Selecteer Azure Resource Manager om verbinding te maken met een AKS-cluster met behulp van een Azure-serviceverbinding. Als u verbinding wilt maken met een Kubernetes-cluster met behulp van kubeconfig of een serviceaccount, kunt u Ook Kubernetes Service Verbinding maken ion selecteren. In dit geval moet u een Kubernetes-serviceverbinding maken en selecteren in plaats van een Azure-abonnement voor de volgende instelling.
- Azure-abonnement: Selecteer een verbinding in de lijst onder Beschikbare Azure Service Verbinding maken ions of maak een meer beperkte machtigingsverbinding met uw Azure-abonnement. Als u een knop Autoriseren naast de invoer ziet, gebruikt u deze om de verbinding met uw Azure-abonnement te autoriseren. Als u het vereiste Azure-abonnement niet in de lijst met abonnementen ziet, raadpleegt u Een Azure-serviceverbinding maken om de verbinding handmatig in te stellen.
- Resourcegroep: voer de resourcegroep in die uw AKS-cluster bevat of selecteer deze.
- Kubernetes-cluster: voer het AKS-cluster in of selecteer dit dat u hebt gemaakt.
- Opdracht: Selecteer init als de Helm-opdracht. Hiermee wordt Tiller geïnstalleerd in uw actieve Kubernetes-cluster. Er wordt ook een lokale configuratie ingesteld die nodig is. Tick Use canary image version to install the latest prerelease version of Tiller. U kunt er ook voor kiezen om Tiller te upgraden als deze vooraf is geïnstalleerd door Upgrade Tiller aan te vinken. Als deze opties zijn ingeschakeld, wordt de taak uitgevoerd helm init --canary-image --upgrade
Kies + in de agenttaak en voeg nog een pakket toe en implementeer Helm-grafiekentaak . Configureer de instellingen voor deze taak als volgt:
- Kubernetes-cluster: voer het AKS-cluster in of selecteer dit dat u hebt gemaakt.
- Naamruimte: Voer uw Kubernetes-clusternaamruimte in waar u uw toepassing wilt implementeren. Kubernetes ondersteunt meerdere virtuele clusters die worden ondersteund door hetzelfde fysieke cluster. Deze virtuele clusters worden naamruimten genoemd. U kunt naamruimten gebruiken om verschillende omgevingen te maken, zoals ontwikkelen, testen en faseren in hetzelfde cluster.
- Opdracht: Selecteer upgraden als de Helm-opdracht. U kunt elke Helm-opdracht uitvoeren met deze taak en opdrachtopties doorgeven als argumenten. Wanneer u de upgrade selecteert, worden in de taak nog enkele velden weergegeven:
  - Grafiektype: Selecteer bestandspad. U kunt ook grafieknaam opgeven als u een URL of een grafieknaam wilt opgeven. Als de grafieknaam bijvoorbeeld is stable/mysql, wordt de taak uitgevoerd helm upgrade stable/mysql
  - Grafiekpad: dit kan een pad naar een verpakte grafiek of een pad naar een uitgepakte grafiekmap zijn. In dit voorbeeld publiceert u de grafiek met behulp van een CI-build, dus selecteer het bestandspakket met behulp van de bestandskiezer of voer het in $(System.DefaultWorkingDirectory)/**/*.tgz
  - Releasenaam: Voer een naam in voor uw release, bijvoorbeeld azuredevops
  - Pods opnieuw maken: schakel dit selectievakje in als er een configuratiewijziging is tijdens de release en u een actieve pod wilt vervangen door de nieuwe configuratie.
  - Waarden opnieuw instellen: schakel dit selectievakje in als u wilt dat de waarden die in de grafiek zijn ingebouwd, alle waarden van de taak overschrijven.
  - Force: Schakel dit selectievakje in als er conflicten optreden, u wilt upgraden en terugdraaien om de resource te verwijderen, opnieuw te maken en de volledige release opnieuw te installeren. Dit is handig in scenario's waarin het toepassen van patches kan mislukken (bijvoorbeeld voor services omdat het IP-adres van het cluster onveranderbaar is).
  - Argumenten: Voer de Helm-opdrachtargumenten en de bijbehorende waarden in; voor dit voorbeeld --set image.repository=$(imageRepoName) --set image.tag=$(Build.BuildId) Zie deze sectie voor een beschrijving van waarom we deze argumenten gebruiken.
  - TLS inschakelen: schakel dit selectievakje in om sterke TLS-verbindingen tussen Helm en Tiller in te schakelen.
  - CA-certificaat: geef een CA-certificaat op dat moet worden geüpload en gebruikt om certificaten uit te geven voor Tiller en Helm-client.
  - Certificaat: Geef het Tiller-certificaat of Helm-clientcertificaat op
  - Sleutel: Geef de Tiller-sleutel of Helm-clientsleutel op
Voeg op de pagina Variabelen van de pijplijn een variabele met de naam imageRepoName toe en stel de waarde in op de naam van uw Helm-installatiekopieënopslagplaats. Normaal gesproken heeft dit de indeling example.azurecr.io/coderepository
Sla de release-pijplijn op.

Argumenten die worden gebruikt in de Helm-upgradetaak

In de build-pijplijn wordt de containerinstallatiekopieën getagd en $(Build.BuildId) wordt deze naar een Azure Container Registry gepusht. In een Helm-grafiek kunt u de details van de containerinstallatiekopieën parameteriseren, zoals de naam en tag, omdat dezelfde grafiek kan worden gebruikt om in verschillende omgevingen te implementeren. Deze waarden kunnen ook worden opgegeven in het bestand values.yaml of worden overschreven door een door de gebruiker opgegeven waardenbestand, dat op zijn beurt kan worden overschreven door --set parameters tijdens de Helm-installatie of -upgrade.

In dit voorbeeld geven we de volgende argumenten door:

--set image.repository=$(imageRepoName) --set image.tag=$(Build.BuildId)

De waarde is $(imageRepoName) ingesteld op de pagina Variabelen (of de sectie variabelen van uw YAML-bestand). U kunt deze ook rechtstreeks vervangen door de naam van de opslagplaats voor de installatiekopieën in de --set argumentenwaarde of het bestand values.yaml . Voorbeeld:

  image:
    repository: VALUE_TO_BE_OVERRIDDEN
    tag: latest

Een ander alternatief is het instellen van de optie Waarden instellen van de taak om de argumentwaarden op te geven als door komma's gescheiden sleutel-waardeparen.

Een release maken om uw app te implementeren

U bent nu klaar om een release te maken. Dit betekent dat u het proces voor het uitvoeren van de release-pijplijn wilt starten met de artefacten die zijn geproduceerd door een specifieke build. Dit resulteert in het implementeren van de build:

Kies + Release en selecteer Een release maken.
Controleer in het deelvenster Een nieuwe release maken of de artefactversie die u wilt gebruiken is geselecteerd en kies Maken.
Kies de releasekoppeling in het informatiebalkbericht. Bijvoorbeeld: 'Release-1 is gemaakt'.
Kies in de pijplijnweergave de statuskoppeling in de fasen van de pijplijn om de logboeken en agentuitvoer te bekijken.

Bouwen en implementeren naar Azure Kubernetes Service met Azure Pipelines

Vereisten

Code ophalen

De Azure-resources maken

Een containerregister maken

Aanmelden bij Azure Pipelines

Maak de pijplijn

Verbinding maken en selecteer uw opslagplaats

Uw app implementeren bekijken

Hoe de pijplijn wordt gebouwd

Resources opschonen

Vereisten

Code ophalen

De Azure-resources maken

Een containerregister maken

Verificatie configureren

Een release-pijplijn maken

Argumenten die worden gebruikt in de Helm-upgradetaak

Een release maken om uw app te implementeren

Aanvullende resources