From 8f419be8e098581711c945aadf2a9586d0321b74 Mon Sep 17 00:00:00 2001 From: Ganga Mahesh Siddem Date: Fri, 12 Mar 2021 17:32:54 -0800 Subject: [PATCH 1/2] doc updates for microsoft charts repo release --- ReleaseProcess.md | 35 ++++++++++++++++++++++++++++++++++- 1 file changed, 34 insertions(+), 1 deletion(-) diff --git a/ReleaseProcess.md b/ReleaseProcess.md index 2a3e6001a..19c0a9240 100644 --- a/ReleaseProcess.md +++ b/ReleaseProcess.md @@ -43,13 +43,46 @@ This needs to be co-ordinated with Red hat and ARO-RP team for the release and Make PR against [AKS-Engine](https://github.com/Azure/aks-engine). Refer PR https://github.com/Azure/aks-engine/pull/2318 -## ARO v4, On-prem K8s, Azure Arc K8s and OpenShift v4 clusters +## ARO v4, Azure Arc K8s and OpenShift v4 clusters Make sure azuremonitor-containers chart yamls updates with all changes going with the release and also make sure to bump the chart version, imagetag and docker provider version etc. Similar to agent container image, build pipeline automatically push the chart to container insights prod acr for canary and prod repos accordingly. Both the agent and helm chart will be replicated to `mcr.microsoft.com`. The way, customers will be onboard the monitoring to these clusters using onboarding scripts under `onboarding\managed` directory so please bump chart version for prod release. Once we move to Arc K8s Monitoring extension Public preview, these will be taken care so at that point of time no manual changes like this required. +## Microsoft Charts Repo release for On-prem K8s + +Since HELM charts repo being deprecated, Microsoft charts repo being used for HELM chart release of on-prem K8s clusters. +To make chart release PR, fork [Microsoft-charts-repo]([https://github.com/microsoft/charts/tree/gh-pages) and make the PR against `gh-pages` branch of the upstream repo. + +Refer PR - https://github.com/microsoft/charts/pull/23 for example. +Once the PR merged, latest version of HELM chart should be available in couple of mins in https://microsoft.github.io/charts/repo and https://artifacthub.io/. + +Instructions to create PR +``` +# 1. create helm package for the release candidate + git clone git@github.com:microsoft/Docker-Provider.git + git checkout ci_prod + cd ~/Docker-Provider/charts/azuremonitor-containers # this path based on where you have cloned the repo + helm package . + +# 2. clone your fork repo and checkout gh_pages branch # gh_pages branch used as release branch + git clone + git checkout gh_pages + +# 3. copy release candidate helm package + cd ~/charts # assumed you have cloned you have forked repo + cd ~/charts-1/repo/azuremonitor-containers + # update chart version value with the version of chart being released + cp ~/Docker-Provider/charts/azuremonitor-containers/azuremonitor-containers-.tgz . + cd ~/charts-1/repo + # update repo index file + helm repo index . + +# 4. Review the changes and make PR. Please note, you may need to revert unrelated changes automatically added by `helm repo index .` command + +``` + # 4. Monitor agent roll-out status In Container Insights Agent (AKS) telemetry dashboard, update the agent roll status by region chart with released agent image and track rollout status. If you see any issues with agent rollout, reach out AKS on-call team for the help on investigation and understanding whats going on. From 6bec2f29745cd50a4d2d7a0751c40d9df346da74 Mon Sep 17 00:00:00 2001 From: Ganga Mahesh Siddem Date: Mon, 22 Mar 2021 14:54:15 -0700 Subject: [PATCH 2/2] wip --- ReleaseProcess.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/ReleaseProcess.md b/ReleaseProcess.md index 19c0a9240..c6f51bb65 100644 --- a/ReleaseProcess.md +++ b/ReleaseProcess.md @@ -67,15 +67,16 @@ Instructions to create PR helm package . # 2. clone your fork repo and checkout gh_pages branch # gh_pages branch used as release branch + cd ~ git clone + cd ~/charts # assumed the root dir of the clone is charts git checkout gh_pages # 3. copy release candidate helm package - cd ~/charts # assumed you have cloned you have forked repo - cd ~/charts-1/repo/azuremonitor-containers + cd ~/charts/repo/azuremonitor-containers # update chart version value with the version of chart being released cp ~/Docker-Provider/charts/azuremonitor-containers/azuremonitor-containers-.tgz . - cd ~/charts-1/repo + cd ~/charts/repo # update repo index file helm repo index .