Hitelesítés az Azure Container Registry (ACR) segítségével az Azure Kubernetes szolgáltatásból (AKS)

• Ha még nem rendelkezik ACR-sel, hozzon létre egyet a az acr create paranccsal. Az alábbi példa a változót MYACR az ACR, a mycontainerregistry nevére állítja, és a beállításjegyzék létrehozásához használja a változót. Az ACR-névnek globálisan egyedinek kell lennie, és csak kisbetűket kell használnia.

  MYACR=mycontainerregistry
  
  az acr create --name $MYACR --resource-group myContainerRegistryResourceGroup --sku basic
  

• Ha még nem rendelkezik ACR-sel, hozzon létre egyet a New-AzContainerRegistry parancsmaggal. Az alábbi példa a változót MYACR az ACR, a mycontainerregistry nevére állítja, és a beállításjegyzék létrehozásához használja a változót. Az ACR-névnek globálisan egyedinek kell lennie, és csak kisbetűket kell használnia.

  $MYACR = 'mycontainerregistry'
  
  New-AzContainerRegistry -Name $MYACR -ResourceGroupName myContainerRegistryResourceGroup -Sku Basic
  

• Hozzon létre egy új AKS-fürtöt, és integráljon egy meglévő ACR-sel a az aks create paraméterrel rendelkező --attach-acr paranccsal. Ez a parancs lehetővé teszi egy meglévő ACR engedélyezését az előfizetésben, és konfigurálja a megfelelő AcrPull-szerepkört a felügyelt identitáshoz.

  MYACR=mycontainerregistry
  
  az aks create --name myAKSCluster --resource-group myResourceGroup --generate-ssh-keys --attach-acr $MYACR
  

  A parancs végrehajtása több percet is igénybe vehet.

  Feljegyzés

  Ha az AKS-fürttől eltérő előfizetésben található ACR-t használ, vagy inkább az ACR-erőforrás-azonosítót szeretné használni az ACR neve helyett, ezt a következő szintaxissal teheti meg:

  az aks create -n myAKSCluster -g myResourceGroup --generate-ssh-keys --attach-acr /subscriptions/<subscription-id>/resourceGroups/myContainerRegistryResourceGroup/providers/Microsoft.ContainerRegistry/registries/myContainerRegistry
  

• Hozzon létre egy új AKS-fürtöt, és integráljon egy meglévő ACR-sel a New-AzAksCluster parancsmag és a -AcrNameToAttach paraméterparaméter használatával. Ez a parancs lehetővé teszi egy meglévő ACR engedélyezését az előfizetésben, és konfigurálja a megfelelő AcrPull-szerepkört a felügyelt identitáshoz.

  $MYACR = 'mycontainerregistry'
  
  New-AzAksCluster -Name myAKSCluster -ResourceGroupName myResourceGroup -GenerateSshKey -AcrNameToAttach $MYACR
  

  A parancs végrehajtása több percet is igénybe vehet.

• Meglévő ACR integrálása meglévő AKS-fürttel a az aks update paraméterrel és az --attach-acr acr-name vagy acr-resource-id érvényes értékével.

  # Attach using acr-name
  az aks update --name myAKSCluster --resource-group myResourceGroup --attach-acr <acr-name>
  
  # Attach using acr-resource-id
  az aks update --name myAKSCluster --resource-group myResourceGroup --attach-acr <acr-resource-id>
  

  Feljegyzés

  A az aks update --attach-acr parancs a parancsot futtató felhasználó engedélyeit használja az ACR-szerepkör-hozzárendelés létrehozásához. Ez a szerepkör a kubelet által felügyelt identitáshoz van rendelve. A felügyelt AKS-identitásokról további információt a felügyelt identitások összegzésében talál.

• Integráljon egy meglévő ACR-t egy meglévő AKS-fürttel a Set-AzAksCluster paraméterrel és az -AcrNameToAttach acr-név érvényes értékével.

  Set-AzAksCluster -Name myAKSCluster -ResourceGroupName myResourceGroup -AcrNameToAttach <acr-name>
  

  Feljegyzés

  A parancsmag futtatása a Set-AzAksCluster -AcrNameToAttach parancsot futtató felhasználó engedélyeit használja az ACR-hozzárendelés létrehozásához. Ez a szerepkör a kubelet által felügyelt identitáshoz van rendelve. A felügyelt AKS-identitásokról további információt a felügyelt identitások összegzésében talál.

• Távolítsa el az ACR és az AKS-fürt közötti integrációt a az aks update paraméterrel és az --detach-acr acr-name vagy acr-resource-id érvényes értékével rendelkező paranccsal.

  # Detach using acr-name
  az aks update --name myAKSCluster --resource-group myResourceGroup --detach-acr <acr-name>
  
  # Detach using acr-resource-id
  az aks update --name myAKSCluster --resource-group myResourceGroup --detach-acr <acr-resource-id>
  

• Távolítsa el az ACR és az AKS-fürt közötti integrációt a Set-AzAksCluster paraméterrel és az-AcrNameToDetach acr-név érvényes értékével rendelkező paranccsal.

  Set-AzAksCluster -Name myAKSCluster -ResourceGroupName myResourceGroup -AcrNameToDetach <acr-name>
  

• Importáljon egy képet a Docker Hubról az ACR-be a az acr import paranccsal.

  az acr import --name <acr-name> --source docker.io/library/nginx:latest --image nginx:v1
  

• Importáljon egy képet a Docker Hubról az ACR-be a [Import-AzContainerRegistryImage] parancsmag használatával.

  Import-AzContainerRegistryImage -RegistryName <acr-name> -ResourceGroupName myResourceGroup -SourceRegistryUri docker.io -SourceImage library/nginx:latest
  

1. Győződjön meg arról, hogy a parancs használatával rendelkezik a az aks get-credentials megfelelő AKS-hitelesítő adatokkal.

   az aks get-credentials --resource-group myResourceGroup --name myAKSCluster
   

2. Hozzon létre egy acr-nginx.yaml nevű fájlt az alábbi YAML-minta használatával, és cserélje le az acr-nevet az ACR nevére.

   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: nginx0-deployment
     labels:
       app: nginx0-deployment
   spec:
     replicas: 2
     selector:
       matchLabels:
         app: nginx0
     template:
       metadata:
         labels:
           app: nginx0
       spec:
         containers:
         - name: nginx
           image: <acr-name>.azurecr.io/nginx:v1
           ports:
           - containerPort: 80
   

3. Futtassa az üzembe helyezést az AKS-fürtben a kubectl apply paranccsal.

   kubectl apply -f acr-nginx.yaml
   

4. Az üzembe helyezés monitorozása a kubectl get pods paranccsal.

   kubectl get pods
   

   A kimenetnek két futó podot kell megjelenítenie, ahogy az a következő példakimenetben is látható:

   NAME                                 READY   STATUS    RESTARTS   AGE
   nginx0-deployment-669dfc4d4b-x74kr   1/1     Running   0          20s
   nginx0-deployment-669dfc4d4b-xdpd6   1/1     Running   0          20s
   

1. Győződjön meg arról, hogy a parancsmaggal rendelkezik a Import-AzAksCredential megfelelő AKS-hitelesítő adatokkal.

   Import-AzAksCredential -ResourceGroupName myResourceGroup -Name myAKSCluster
   

2. Hozzon létre egy acr-nginx.yaml nevű fájlt az alábbi YAML-minta használatával, és cserélje le az acr-nevet az ACR nevére.

   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: nginx0-deployment
     labels:
       app: nginx0-deployment
   spec:
     replicas: 2
     selector:
       matchLabels:
         app: nginx0
     template:
       metadata:
         labels:
           app: nginx0
       spec:
         containers:
         - name: nginx
           image: <acr-name>.azurecr.io/nginx:v1
           ports:
           - containerPort: 80
   

3. Futtassa az üzembe helyezést az AKS-fürtben a kubectl apply paranccsal.

   kubectl apply -f acr-nginx.yaml
   

4. Az üzembe helyezés monitorozása a kubectl get pods paranccsal.

   kubectl get pods
   

   A kimenetnek két futó podot kell megjelenítenie, ahogy az a következő példakimenetben is látható:

   NAME                                 READY   STATUS    RESTARTS   AGE
   nginx0-deployment-669dfc4d4b-x74kr   1/1     Running   0          20s
   nginx0-deployment-669dfc4d4b-xdpd6   1/1     Running   0          20s
   

Az ACR konfigurálása privát kapcsolattal az Azure HTTP Proxy és az AKS használatával

Az ACR-nek két végpontja van:

• REST-végpont: {REGISTRY_NAME}.azurecr.io
• Adatvégpont: {REGISTRY_NAME}.{REGISTRY_LOCATION}.data.azurecr.io

1. Győződjön meg arról, hogy noProxy a többi és az adatvégpont hozzá van adva a HTTP-proxy konfigurációja alatt.

{
  "httpProxy": "string",
  "httpsProxy": "string",
  "noProxy": [
    "{REGISTRY_NAME}.azurecr.io",
    "{REGISTRY_NAME}.{REGISTRY_LOCATION}.data.azurecr.io"
  ],
  "trustedCa": "string"
}

2. Ellenőrizze a naplókon keresztül, hogy a forgalom privát kapcsolaton keresztül történik-e.