Kurz: Nasazení aplikací pomocí GitOps s flux v2

Pro clustery Kubernetes s podporou Azure Arc

• Připojený cluster Kubernetes s podporou Azure Arc, který je spuštěný. Clustery založené na ARM64 se podporují od microsoft.flux verze 1.7.0.

  Zjistěte, jak připojit cluster Kubernetes ke službě Azure Arc. Pokud se potřebujete připojit přes odchozí proxy server, ujistěte se, že nainstalujete agenty Arc s nastavením proxy serveru.

• Oprávnění ke čtení a zápisu pro Microsoft.Kubernetes/connectedClusters typ prostředku

Pro clustery Azure Kubernetes Service

• Cluster AKS založený na MSI, který je spuštěný a spuštěný.

  Důležité

  Ujistěte se, že je cluster AKS vytvořený pomocí MSI (nikoli hlavního microsoft.flux názvu služby), protože rozšíření nebude fungovat s clustery AKS založenými na SPN. U nových clusterů AKS vytvořených pomocí az aks createtéto služby je cluster ve výchozím nastavení založený na MSI. U již vytvořených clusterů založených na SPN, které je potřeba převést na MSI, spusťte az aks update -g $RESOURCE_GROUP -n $CLUSTER_NAME --enable-managed-identitypříkaz . Další informace najdete v tématu Použití spravované identity v AKS.

• Oprávnění ke čtení a zápisu pro Microsoft.ContainerService/managedClusters typ prostředku

Společné pro oba typy clusterů

• Oprávnění ke čtení a zápisu u těchto typů prostředků:

  • Microsoft.KubernetesConfiguration/extensions
  • Microsoft.KubernetesConfiguration/fluxConfigurations

• Azure CLI verze 2.15 nebo novější. Nainstalujte Azure CLI nebo pomocí následujících příkazů aktualizujte na nejnovější verzi:

  az version
  az upgrade
  

• Klient příkazového řádku Kubernetes, kubectl. kubectl je už nainstalovaný, pokud používáte Azure Cloud Shell.

  Pomocí příkazu nainstalujte kubectl místně az aks install-cli :

  az aks install-cli
  

• Registrace následujících poskytovatelů prostředků Azure:

  az provider register --namespace Microsoft.Kubernetes
  az provider register --namespace Microsoft.ContainerService
  az provider register --namespace Microsoft.KubernetesConfiguration
  

  Registrace je asynchronní proces a měla by se dokončit do 10 minut. Pokud chcete monitorovat proces registrace, použijte následující příkaz:

  az provider show -n Microsoft.KubernetesConfiguration -o table
  
  Namespace                          RegistrationPolicy    RegistrationState
  ---------------------------------  --------------------  -------------------
  Microsoft.KubernetesConfiguration  RegistrationRequired  Registered
  

Podpora verzí a oblastí

GitOps se v současné době podporuje ve všech oblastech, které Kubernetes s podporou Azure Arc podporuje. GitOps se v současné době podporuje v podmnožině oblastí, které podporuje AKS. Služba GitOps přidává nové podporované oblasti v pravidelných intervalech.

Podporují se nejnovější verze rozšíření Flux v2 a dvě předchozí verze (N-2). Obecně doporučujeme použít nejnovější verzi rozšíření.

Síťové požadavky

Aby mohli fungovat, vyžadují agenti GitOps odchozí (výchozí přenos dat) TCP do zdroje úložiště na portu 22 (SSH) nebo portu 443 (HTTPS). Agenti také vyžadují přístup k následujícím odchozím adresám URL:

Povolení rozšíření rozhraní příkazového řádku

Nainstalujte nejnovější k8s-configuration balíčky rozšíření rozhraní příkazového řádku a k8s-extension rozhraní příkazového řádku:

az extension add -n k8s-configuration
az extension add -n k8s-extension

Aktualizace těchto balíčků na nejnovější verze:

az extension update -n k8s-configuration
az extension update -n k8s-extension

Pokud chcete zobrazit seznam všech nainstalovaných rozšíření Azure CLI a jejich verzí, použijte následující příkaz:

az extension list -o table

Experimental   ExtensionType   Name                   Path                                                       Preview   Version
-------------  --------------  -----------------      -----------------------------------------------------      --------  --------
False          whl             connectedk8s           C:\Users\somename\.azure\cliextensions\connectedk8s         False     1.2.7
False          whl             k8s-configuration      C:\Users\somename\.azure\cliextensions\k8s-configuration    False     1.5.0
False          whl             k8s-extension          C:\Users\somename\.azure\cliextensions\k8s-extension        False     1.1.0

Pro clustery Kubernetes s podporou Azure Arc

• Připojený cluster Kubernetes s podporou Azure Arc, který je spuštěný. Clustery založené na ARM64 se podporují od microsoft.flux verze 1.7.0.

  Zjistěte, jak připojit cluster Kubernetes ke službě Azure Arc. Pokud se potřebujete připojit přes odchozí proxy server, ujistěte se, že nainstalujete agenty Arc s nastavením proxy serveru.

• Oprávnění ke čtení a zápisu pro Microsoft.Kubernetes/connectedClusters typ prostředku

Pro clustery Azure Kubernetes Service

• Cluster AKS založený na MSI, který je spuštěný a spuštěný.

  Důležité

  Ujistěte se, že je cluster AKS vytvořený pomocí MSI (nikoli hlavního microsoft.flux názvu služby), protože rozšíření nebude fungovat s clustery AKS založenými na SPN. U nových clusterů AKS vytvořených pomocí az aks createtéto služby je cluster ve výchozím nastavení založený na MSI. U již vytvořených clusterů založených na SPN, které je potřeba převést na MSI, spusťte az aks update -g $RESOURCE_GROUP -n $CLUSTER_NAME --enable-managed-identitypříkaz . Další informace najdete v tématu Použití spravované identity v AKS.

• Oprávnění ke čtení a zápisu pro Microsoft.ContainerService/managedClusters typ prostředku

Společné pro oba typy clusterů

• Oprávnění ke čtení a zápisu u těchto typů prostředků:

  • Microsoft.KubernetesConfiguration/extensions
  • Microsoft.KubernetesConfiguration/fluxConfigurations

• Registrace následujících poskytovatelů prostředků Azure:

  • Microsoft.ContainerService
  • Microsoft.Kubernetes
  • Microsoft.KubernetesConfiguration

Podpora verzí a oblastí

GitOps se v současné době podporuje ve všech oblastech, které Kubernetes s podporou Azure Arc podporuje. GitOps se v současné době podporuje v podmnožině oblastí, které podporuje AKS. Služba GitOps přidává nové podporované oblasti v pravidelných intervalech.

Podporují se nejnovější verze rozšíření Flux v2 a dvě předchozí verze (N-2). Obecně doporučujeme použít nejnovější verzi rozšíření.

Síťové požadavky

Aby mohli fungovat, vyžadují agenti GitOps odchozí (výchozí přenos dat) TCP do zdroje úložiště na portu 22 (SSH) nebo portu 443 (HTTPS). Agenti také vyžadují přístup k následujícím odchozím adresám URL:

Následující příklad používá az k8s-configuration flux create příkaz k použití konfigurace Flux v clusteru pomocí následujících hodnot a nastavení:

• Skupina prostředků, která obsahuje cluster, je flux-demo-rg.
• Název clusteru Azure Arc je flux-demo-arc.
• Typ clusteru je Azure Arc (-t connectedClusters), ale tento příklad funguje také s AKS (-t managedClusters).
• Název konfigurace Flux je cluster-config.
• Obor názvů pro instalaci konfigurace je cluster-config.
• Adresa URL veřejného úložiště Git je https://github.com/Azure/gitops-flux2-kustomize-helm-mt.
• Větev úložiště Git je main.
• Rozsah konfigurace je cluster. Tento obor dává operátorům oprávnění provádět změny v celém clusteru. Pokud chcete v tomto kurzu použít namespace obor, podívejte se na potřebné změny.
• Dvě kustomizace jsou zadány s názvy infra a apps. Každá z nich je přidružená k cestě v úložišti.
• Kustomizace apps závisí na infra kustomizaci. (Kustomizace infra musí být dokončena před spuštěním apps kustomizace.)
• Nastavte prune=true na obě kustomizace. Toto nastavení zajistí, že se objekty, které flux nasazené do clusteru nasadí, vyčistí, pokud jsou odebrány z úložiště nebo pokud dojde k odstranění konfigurace fluxu nebo kustomizace.

az k8s-configuration flux create -g flux-demo-rg \
-c flux-demo-arc \
-n cluster-config \
--namespace cluster-config \
-t connectedClusters \
--scope cluster \
-u https://github.com/Azure/gitops-flux2-kustomize-helm-mt \
--branch main  \
--kustomization name=infra path=./infrastructure prune=true \
--kustomization name=apps path=./apps/staging prune=true dependsOn=\["infra"\]

Rozšíření microsoft.flux se nainstaluje do clusteru (pokud jste ho ještě nenainstalovali v předchozím nasazení GitOps).

Při první instalaci konfigurace fluxu může být Pending počáteční stav dodržování předpisů nebo Non-compliant proto, že stále probíhá odsouhlasení. Po minutě nebo tak znovu zadejte dotaz na konfiguraci, abyste viděli konečný stav dodržování předpisů.

az k8s-configuration flux show -g flux-demo-rg -c flux-demo-arc -n cluster-config -t connectedClusters

Pokud chcete ověřit, že nasazení proběhlo úspěšně, spusťte následující příkaz:

az k8s-configuration flux show -g flux-demo-rg -c flux-demo-arc -n cluster-config -t connectedClusters

Při úspěšném nasazení se vytvoří následující obory názvů:

• flux-system: Obsahuje kontrolery rozšíření Flux.
• cluster-config: Obsahuje objekty konfigurace Flux.
• nginx, , podinforedis: Obory názvů pro úlohy popsané v manifestech v úložišti Git.

Pokud chcete potvrdit obory názvů, spusťte následující příkaz:

kubectl get namespaces

Obor flux-system názvů obsahuje objekty rozšíření Flux:

• Kontrolery Azure Flux: fluxconfig-agent, fluxconfig-controller
• OSS Flux controllers: source-controller, kustomize-controller, helm-controller, notification-controller

Pody agenta Flux a kontroleru by měly být ve spuštěném stavu. Potvrďte to pomocí následujícího příkazu:

kubectl get pods -n flux-system

NAME                                      READY   STATUS    RESTARTS   AGE
fluxconfig-agent-9554ffb65-jqm8g          2/2     Running   0          21m
fluxconfig-controller-9d99c54c8-nztg8     2/2     Running   0          21m
helm-controller-59cc74dbc5-77772          1/1     Running   0          21m
kustomize-controller-5fb7d7b9d5-cjdhx     1/1     Running   0          21m
notification-controller-7d45678bc-fvlvr   1/1     Running   0          21m
source-controller-df7dc97cd-4drh2         1/1     Running   0          21m

Obor názvů cluster-config má objekty konfigurace Flux.

kubectl get crds

NAME                                                   CREATED AT
alerts.notification.toolkit.fluxcd.io                  2022-04-06T17:15:48Z
arccertificates.clusterconfig.azure.com                2022-03-28T21:45:19Z
azureclusteridentityrequests.clusterconfig.azure.com   2022-03-28T21:45:19Z
azureextensionidentities.clusterconfig.azure.com       2022-03-28T21:45:19Z
buckets.source.toolkit.fluxcd.io                       2022-04-06T17:15:48Z
connectedclusters.arc.azure.com                        2022-03-28T21:45:19Z
customlocationsettings.clusterconfig.azure.com         2022-03-28T21:45:19Z
extensionconfigs.clusterconfig.azure.com               2022-03-28T21:45:19Z
fluxconfigs.clusterconfig.azure.com                    2022-04-06T17:15:48Z
gitconfigs.clusterconfig.azure.com                     2022-03-28T21:45:19Z
gitrepositories.source.toolkit.fluxcd.io               2022-04-06T17:15:48Z
helmcharts.source.toolkit.fluxcd.io                    2022-04-06T17:15:48Z
helmreleases.helm.toolkit.fluxcd.io                    2022-04-06T17:15:48Z
helmrepositories.source.toolkit.fluxcd.io              2022-04-06T17:15:48Z
imagepolicies.image.toolkit.fluxcd.io                  2022-04-06T17:15:48Z
imagerepositories.image.toolkit.fluxcd.io              2022-04-06T17:15:48Z
imageupdateautomations.image.toolkit.fluxcd.io         2022-04-06T17:15:48Z
kustomizations.kustomize.toolkit.fluxcd.io             2022-04-06T17:15:48Z
providers.notification.toolkit.fluxcd.io               2022-04-06T17:15:48Z
receivers.notification.toolkit.fluxcd.io               2022-04-06T17:15:48Z
volumesnapshotclasses.snapshot.storage.k8s.io          2022-03-28T21:06:12Z
volumesnapshotcontents.snapshot.storage.k8s.io         2022-03-28T21:06:12Z
volumesnapshots.snapshot.storage.k8s.io                2022-03-28T21:06:12Z
websites.extensions.example.com                        2022-03-30T23:42:32Z

Další podrobnosti o konfiguraci potvrďte pomocí následujících příkazů.

kubectl get fluxconfigs -A

NAMESPACE        NAME             SCOPE     URL                                                       PROVISION   AGE
cluster-config   cluster-config   cluster   https://github.com/Azure/gitops-flux2-kustomize-helm-mt   Succeeded   44m

kubectl get gitrepositories -A

NAMESPACE        NAME             URL                                                       READY   STATUS                                                            AGE
cluster-config   cluster-config   https://github.com/Azure/gitops-flux2-kustomize-helm-mt   True    Fetched revision: main/4f1bdad4d0a54b939a5e3d52c51464f67e474fcf   45m

kubectl get helmreleases -A

NAMESPACE        NAME      READY   STATUS                             AGE
cluster-config   nginx     True    Release reconciliation succeeded   66m
cluster-config   podinfo   True    Release reconciliation succeeded   66m
cluster-config   redis     True    Release reconciliation succeeded   66m

kubectl get kustomizations -A


NAMESPACE        NAME                   READY   STATUS                                                            AGE
cluster-config   cluster-config-apps    True    Applied revision: main/4f1bdad4d0a54b939a5e3d52c51464f67e474fcf   65m
cluster-config   cluster-config-infra   True    Applied revision: main/4f1bdad4d0a54b939a5e3d52c51464f67e474fcf   65m

Úlohy se nasazují z manifestů v úložišti Git.

kubectl get deploy -n nginx

NAME                                       READY   UP-TO-DATE   AVAILABLE   AGE
nginx-ingress-controller                   1/1     1            1           67m
nginx-ingress-controller-default-backend   1/1     1            1           67m

kubectl get deploy -n podinfo

NAME      READY   UP-TO-DATE   AVAILABLE   AGE
podinfo   1/1     1            1           68m

kubectl get all -n redis

NAME                 READY   STATUS    RESTARTS   AGE
pod/redis-master-0   1/1     Running   0          68m

NAME                     TYPE        CLUSTER-IP    EXTERNAL-IP   PORT(S)    AGE
service/redis-headless   ClusterIP   None          <none>        6379/TCP   68m
service/redis-master     ClusterIP   10.0.13.182   <none>        6379/TCP   68m

NAME                            READY   AGE
statefulset.apps/redis-master   1/1     68m

Řízení, které kontrolery se nasazují pomocí rozšíření clusteru Flux

V některých scénářích můžete chtít změnit, které kontrolery Flux jsou nainstalované s rozšířením clusteru Flux.

Kontrolery source, , helmkustomizea notification Flux jsou ve výchozím nastavení nainstalovány. Řadiče image-automation používané image-reflectork aktualizaci úložiště Git, když jsou k dispozici nové image kontejneru, musí být explicitně povolené.

Pomocí příkazu můžete k8s-extension změnit výchozí možnosti:

• --config source-controller.enabled=<true/false> (výchozí true)
• --config helm-controller.enabled=<true/false> (výchozí true)
• --config kustomize-controller.enabled=<true/false> (výchozí true)
• --config notification-controller.enabled=<true/false> (výchozí true)
• --config image-automation-controller.enabled=<true/false> (výchozí false)
• --config image-reflector-controller.enabled=<true/false> (výchozí false)

Pokud chcete například zakázat oznámení, můžete nastavit notification-controller.enabled možnost false.

Tento ukázkový příkaz nainstaluje image-reflector a image-automation kontrolery. Pokud se rozšíření Flux vytvořilo automaticky při prvním vytvoření konfigurace Flux, název rozšíření je flux.

az k8s-extension create -g <cluster_resource_group> -c <cluster_name> -t <connectedClusters or managedClusters or provisionedClusters> --name flux --extension-type microsoft.flux --config image-automation-controller.enabled=true image-reflector-controller.enabled=true

Použití identity Kubelet jako metody ověřování pro clustery AKS

U clusterů AKS je jednou z možností ověřování, která se má použít, identita kubeletu. Ve výchozím nastavení vytvoří AKS ve spravované skupině prostředků vlastní identitu kubeletu. Pokud chcete, můžete použít předem vytvořenou spravovanou identitu kubeletu. Uděláte to tak, že přidáte parametr --config useKubeletIdentity=true v době instalace rozšíření Flux.

az k8s-extension create --resource-group <resource-group> --cluster-name <cluster-name> --cluster-type managedClusters --name flux --extension-type microsoft.flux --config useKubeletIdentity=true

Pokyny k onboardingu Red Hat OpenShiftu

Kontrolery flux vyžadují pro správné zřizování podů v clusteru omezení kontextu zabezpečení, které není kořenové. Před nasazením rozšíření je nutné tato omezení přidat do clusteru microsoft.flux .

NS="flux-system"
oc adm policy add-scc-to-user nonroot system:serviceaccount:$NS:kustomize-controller
oc adm policy add-scc-to-user nonroot system:serviceaccount:$NS:helm-controller
oc adm policy add-scc-to-user nonroot system:serviceaccount:$NS:source-controller
oc adm policy add-scc-to-user nonroot system:serviceaccount:$NS:notification-controller
oc adm policy add-scc-to-user nonroot system:serviceaccount:$NS:image-automation-controller
oc adm policy add-scc-to-user nonroot system:serviceaccount:$NS:image-reflector-controller

Další informace o pokynech k sadě OpenShift pro onboarding Flux najdete v dokumentaci k fluxu.

Azure Portal je užitečný pro správu konfigurací GitOps a rozšíření Flux v clusterech Kubernetes nebo AKS s podporou Služby Arc. Na webu Azure Portal můžete zobrazit všechny konfigurace Flux přidružené ke každému clusteru a získat podrobné informace, včetně celkového stavu dodržování předpisů jednotlivých clusterů.

Pokud chcete použít ukázkovou konfiguraci fluxu v clusteru, postupujte podle těchto kroků. V rámci tohoto procesu Azure nainstaluje microsoft.flux rozšíření do clusteru, pokud ho ještě nenainstalovali v předchozím nasazení.

1. Přejděte ke svému clusteru na webu Azure Portal.

2. V nabídce služby v části Nastavení vyberte GitOps>Create.

3. V části Základy:

   1. Zadejte název konfigurace.
   2. Zadejte obor názvů, ve kterém se nainstalují vlastní prostředky Flux. Může se jednat o existující obor názvů nebo nový obor názvů, který se vytvoří při nasazení konfigurace.
   3. V části Obor vyberte Cluster , aby operátor Flux získal přístup k použití konfigurace pro všechny obory názvů v clusteru. Pokud chcete v tomto kurzu použít namespace obor, podívejte se na potřebné změny.
   4. Pokračujte v části Zdroj výběrem možnosti Další.

   

4. V části Zdroj:

   1. Ve zdrojovém typu vyberte Úložiště Git.
   2. Zadejte adresu URL úložiště, kde se nacházejí manifesty Kubernetes: https://github.com/Azure/gitops-flux2-kustomize-helm-mt.
   3. Jako typ odkazu vyberte Větev. Ponechte větev nastavenou na hlavní.
   4. Jako typ úložiště vyberte Veřejný.
   5. Ostatní možnosti ponechte nastavené na výchozí a pak vyberte Další.

   

5. V části Kustomizations vytvořte dvě kustomizace: infrastructure a staging. Tyto kustomizace jsou prostředky Flux, které jsou přidružené k cestě v úložišti, které představují sadu manifestů, které by flux měly odsouhlasit s clusterem.

   1. Vyberte Vytvořit.

   2. Na obrazovce Vytvořit kustomizaci :

      1. Jako název instance zadejte infrastrukturu.

      2. Jako cestu zadejte ./infrastructure.

      3. Zaškrtněte políčko Prořezávat. Toto nastavení zajistí, že se objekty, které flux nasazené do clusteru nasadí, vyčistí, pokud jsou odebrány z úložiště nebo pokud dojde k odstranění konfigurace fluxu nebo kustomizace.

      4. Ostatní možnosti ponechte tak, jak je, a pak výběrem možnosti Uložit vytvořte infrastructure kustomizaci.

         

   3. Kustomizace se zobrazí infrastructure v části Kustomizations . Pokud chcete vytvořit další kustomizaci, vyberte Vytvořit.

   4. Na obrazovce Vytvořit kustomizaci :

      1. Jako název instance zadejte přípravný název.

      2. Jako cestu zadejte ./apps/staging.

      3. Zaškrtněte políčko Prořezávat.

      4. V poli Závisí na vyberte infrastrukturu.

      5. Ostatní možnosti ponechte tak, jak je, a pak výběrem možnosti Uložit vytvořte staging kustomizaci.

         

   5. Teď byste měli vidět obě kustomizace uvedené v části Kustomizations . Pokračujte výběrem tlačítka Další.

6. Zkontrolujte možnosti, které jste vybrali v předchozích krocích. Pak výběrem možnosti Vytvořit dokončete vytváření konfigurace GitOps.

Zobrazení konfigurací a objektů

Pokud chcete zobrazit všechny konfigurace clusteru, přejděte do clusteru a v nabídce služby vyberte GitOps .

Výběrem názvu konfigurace zobrazíte další podrobnosti, jako je stav konfigurace, vlastnosti a zdroj. Pak můžete vybrat objekty Konfigurace a zobrazit všechny objekty , které byly vytvořeny, aby se povolila konfigurace GitOps. Díky tomu můžete rychle zobrazit stav dodržování předpisů a další podrobnosti o jednotlivých objektech.

Pokud chcete zobrazit další prostředky Kubernetes nasazené v clusteru, vraťte se na stránku přehledu clusteru a v nabídce služby vyberte prostředky Kubernetes.

Pokud chcete zobrazit podrobné podmínky pro objekt konfigurace, vyberte jeho název.

Další informace najdete v tématu Monitorování stavu a aktivity GitOps (Flux v2).

Odstranění konfigurací fluxu

Následující příkaz odstraní fluxConfigurations prostředek v Azure i objekty konfigurace Flux v clusteru. Vzhledem k tomu, že konfigurace Flux byla původně vytvořena s parametrem prune=true pro kustomizaci, všechny objekty vytvořené v clusteru založené na manifestech v úložišti Git se při odebrání konfigurace Flux odeberou. Tento příkaz ale neodebere samotné rozšíření Flux.

az k8s-configuration flux delete -g flux-demo-rg -c flux-demo-arc -n cluster-config -t connectedClusters --yes

Odstranění rozšíření clusteru Flux

Když odstraníte rozšíření Flux, odeberou se prostředky microsoft.flux rozšíření v Azure i objekty rozšíření Flux v clusteru.

Pokud se rozšíření Flux vytvořilo automaticky při prvním vytvoření konfigurace Flux, název rozšíření je flux.

az k8s-extension delete -g flux-demo-rg -c flux-demo-arc -n flux -t connectedClusters --yes

Odstranění konfigurace fluxu

Pokud chcete odstranit konfiguraci Flux, přejděte do clusteru, ve kterém byla konfigurace vytvořena, a v nabídce služby vyberte GitOps . Vyberte konfiguraci, kterou chcete odstranit. V horní části stránky vyberte Odstranit a po zobrazení výzvy k potvrzení znovu vyberte Odstranit .

Když odstraníte konfiguraci fluxu, odstraní se všechny objekty konfigurace Flux v clusteru. Tato akce ale neodstraní microsoft.flux samotné rozšíření.

Odstranění rozšíření clusteru Flux

Když odstraníte rozšíření Flux, odeberou se prostředky microsoft.flux rozšíření v Azure i objekty rozšíření Flux v clusteru.

V případě clusteru Kubernetes s podporou Azure Arc přejděte do clusteru a vyberte Rozšíření. flux Vyberte rozšíření a vyberte Odinstalovat a pak odstranění potvrďte.

U clusterů AKS nemůžete rozšíření odstranit pomocí webu Azure Portal. Místo toho použijte následující příkaz Azure CLI:

az k8s-extension delete -g <resource-group> -c <cluster-name> -n flux -t managedClusters --yes