From bdc78fc8402923100fc35db194eff2d99c01fa91 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Gon=C3=A7alo=20Heleno?=
 <33546359+lentidas@users.noreply.github.com>
Date: Wed, 9 Oct 2024 15:53:14 +0200
Subject: [PATCH] docs: update CHANGELOG.md

---
 CHANGELOG.md | 68 ++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 68 insertions(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index e8d37ca..e98e179 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -11,6 +11,74 @@
 
 * point the Argo CD provider to the new repository ([#39](https://github.com/camptocamp/devops-stack-module-ebs-csi-driver/issues/39)) ([8b9453e](https://github.com/camptocamp/devops-stack-module-ebs-csi-driver/commit/8b9453ed6f612d8374a091e3dcac02047e8843d2))
 
+### Migrate provider source `oboukili` -> `argoproj-labs`
+
+We've tested the procedure found [here](https://github.com/argoproj-labs/terraform-provider-argocd?tab=readme-ov-file#migrate-provider-source-oboukili---argoproj-labs) and we think the order of the steps is not exactly right. This is the procedure we recommend (**note that this should be run manually on your machine and not on a CI/CD workflow**):
+
+1. First, make sure you are already using version 6.2.0 of the `oboukili/argocd` provider.
+
+1. Then, check which modules you have that are using the `oboukili/argocd` provider.
+
+```shell
+$ terraform providers
+
+Providers required by configuration:
+.
+├── provider[registry.terraform.io/hashicorp/helm] 2.15.0
+├── (...)
+└── provider[registry.terraform.io/oboukili/argocd] 6.2.0
+
+Providers required by state:
+
+    (...)
+
+    provider[registry.terraform.io/oboukili/argocd]
+
+    provider[registry.terraform.io/hashicorp/helm]
+```
+
+3. Afterwards, proceed to point **ALL*  the DevOps Stack modules to the versions that have changed the source on their respective requirements. In case you have other personal modules that also declare `oboukili/argocd` as a requirement, you will also need to update them.
+
+4. Also update the required providers on your root module. If you've followed our examples, you should find that configuration on the `terraform.tf` file in the root folder.
+
+5. Execute the migration  via `terraform state replace-provider`:
+
+```bash
+$ terraform state replace-provider registry.terraform.io/oboukili/argocd registry.terraform.io/argoproj-labs/argocd
+Terraform will perform the following actions:
+
+  ~ Updating provider:
+    - registry.terraform.io/oboukili/argocd
+    + registry.terraform.io/argoproj-labs/argocd
+
+Changing 13 resources:
+
+  module.argocd_bootstrap.argocd_project.devops_stack_applications
+  module.secrets.module.secrets.argocd_application.this
+  module.metrics-server.argocd_application.this
+  module.efs.argocd_application.this
+  module.loki-stack.module.loki-stack.argocd_application.this
+  module.thanos.module.thanos.argocd_application.this
+  module.cert-manager.module.cert-manager.argocd_application.this
+  module.kube-prometheus-stack.module.kube-prometheus-stack.argocd_application.this
+  module.argocd.argocd_application.this
+  module.traefik.module.traefik.module.traefik.argocd_application.this
+  module.ebs.argocd_application.this
+  module.helloworld_apps.argocd_application.this
+  module.helloworld_apps.argocd_project.this
+
+Do you want to make these changes?
+Only 'yes' will be accepted to continue.
+
+Enter a value: yes
+
+Successfully replaced provider for 13 resources.
+```
+
+6. Perform a `terraform init -upgrade` to upgrade your local `.terraform` folder.
+
+7. Run a `terraform plan` or `terraform apply` and you should see that everything is OK and that no changes are necessary. 
+
 ## [3.6.0](https://github.com/camptocamp/devops-stack-module-ebs-csi-driver/compare/v3.5.0...v3.6.0) (2024-08-29)