Skip to content

Commit cff7880

Browse files
Merge pull request #226597 from JnHs/jh-arck8-gitopsm
update info
2 parents dc97fe2 + d587825 commit cff7880

File tree

1 file changed

+32
-5
lines changed

1 file changed

+32
-5
lines changed

articles/azure-arc/kubernetes/conceptual-gitops-flux2.md

Lines changed: 32 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: "GitOps Flux v2 configurations with AKS and Azure Arc-enabled Kubernetes"
33
description: "This article provides a conceptual overview of GitOps in Azure for use in Azure Arc-enabled Kubernetes and Azure Kubernetes Service (AKS) clusters."
4-
ms.date: 02/02/2023
4+
ms.date: 02/07/2023
55
ms.topic: conceptual
66
---
77

@@ -29,7 +29,7 @@ GitOps is enabled in an Azure Arc-enabled Kubernetes or AKS cluster as a `Micros
2929

3030
### Version support
3131

32-
The most recent version of the Flux v2 extension and the two previous versions (N-2) are supported. We generally recommend that you use the most recent version of the extension.
32+
The most recent version of the Flux v2 extension and the two previous versions (N-2) are supported. We generally recommend that you use the [most recent version](extensions-release.md#flux-gitops) of the extension.
3333

3434
> [!NOTE]
3535
> Eventually Azure will stop supporting GitOps with Flux v1, so we recommend [migrating to Flux v2](#migrate-from-flux-v1) as soon as possible.
@@ -611,7 +611,18 @@ az k8s-extension update --configuration-settings multiTenancy.enforce=false -c C
611611

612612
## Migrate from Flux v1
613613

614-
If you've been using Flux v1 in Azure Arc-enabled Kubernetes or AKS clusters and want to migrate to using Flux v2 in the same clusters, you first need to delete the Flux v1 `sourceControlConfigurations` from the clusters. The `microsoft.flux` cluster extension won't install if there are Flux v1 `sourceControlConfigurations` resources in the cluster.
614+
If you are still using Flux v1, we recommend migrating to Flux v2 as soon as possible.
615+
616+
To migrate to using Flux v2 in the same clusters where you've been using Flux v1, you first need to delete all Flux v1 `sourceControlConfigurations` from the clusters. Because Flux v2 has a fundamentally different architecture, the `microsoft.flux` cluster extension won't install if there are Flux v1 `sourceControlConfigurations` resources in a cluster.
617+
618+
Removing Flux v1 `sourceControlConfigurations` will not stop any applications that are running on the clusters. However, When you remove Flux v1 configurations and then deploy Flux v2 configurations:
619+
620+
* If there are new changes in the application manifests stored in a Git repository, these will not be pulled during the migration, and the application version deployed on the cluster will be stale.
621+
* If there are unintended changes in the cluster state and it deviates from the desired state specified in source Git repository, the cluster will not be able to self-heal.
622+
623+
We recommend testing your migration scenario in a development environment before migrating your production environment. The process of removing Flux v1 configurations and deploying Flux v2 configurations should not take more than 30 minutes.
624+
625+
### View and delete Flux v1 configurations
615626

616627
Use these Azure CLI commands to find and then delete existing `sourceControlConfigurations` in a cluster:
617628

@@ -620,10 +631,26 @@ az k8s-configuration list --cluster-name <Arc or AKS cluster name> --cluster-typ
620631
az k8s-configuration delete --name <configuration name> --cluster-name <Arc or AKS cluster name> --cluster-type <connectedClusters OR managedClusters> --resource-group <resource group name>
621632
```
622633

623-
You can also use the Azure portal to view and delete existing GitOps configurations in Azure Arc-enabled Kubernetes or AKS clusters.
634+
You can also view and delete existing GitOps configurations for a cluster in the Azure portal. To do so, navigate to the cluster where the configuration was created and select **GitOps** in the left pane. Select the configuration, then select **Delete**.
635+
636+
### Deploy Flux v2 configurations
637+
638+
Use the Azure portal or Azure CLI to [apply Flux v2 configurations](tutorial-use-gitops-flux2.md#apply-a-flux-configuration) to your clusters.
639+
640+
### Flux v1 retirement information
641+
642+
The open-source project of Flux v1 has been archived, and feature development has been stopped indefinitely. For more information, see the [fluxcd project](https://fluxcd.io/docs/migration/).
643+
644+
Flux v2 was launched as the upgraded open-source project of Flux. It has a new architecture and supports more GitOps use cases. Microsoft launched a version of an extension using Flux v2 in May 2022. Since then, customers have been advised to move to Flux v2 within three years, as support for using Flux v1 is scheduled to end in May 2025.
624645

625-
More information about migration from Flux v1 to Flux v2 is available in the fluxcd project: [Migrate from Flux v1 to v2](https://fluxcd.io/docs/migration/).
646+
Key new features introduced in the GitOps extension for Flux v2:
626647

648+
* Flux v1 is a monolithic do-it-all operator. Flux v2 separates the functionalities into [specialized controllers](#controllers) (Source controller, Kustomize controller, Helm controller, and Notification controller).
649+
* Supports synchronization with multiple source repositories.
650+
* Supports [multi-tenancy](#multi-tenancy), like applying each source repository with its own set of permissions
651+
* Provides operational insights through health checks, events and alerts.
652+
* Supports Git branches, pinning on commits and tags, and following SemVer tag ranges.
653+
* Credentials configuration per GitRepository resource: SSH private key, HTTP/S username/password/token, and OpenPGP public keys.
627654

628655
## Next steps
629656

0 commit comments

Comments
 (0)