Skip to content

Commit 4c51a63

Browse files
authored
Update best-practices-onboard-deploy.md
Expanded on cert-mgr considerations.
1 parent 6f77c11 commit 4c51a63

File tree

1 file changed

+17
-2
lines changed

1 file changed

+17
-2
lines changed

articles/operator-service-manager/best-practices-onboard-deploy.md

Lines changed: 17 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Best practices for Azure Operator Service Manager
33
description: Understand best practices for Azure Operator Service Manager to onboard and deploy a network function (NF).
44
author: msftadam
55
ms.author: adamdor
6-
ms.date: 09/11/2023
6+
ms.date: 08/09/2024
77
ms.topic: best-practice
88
ms.service: azure-operator-service-manager
99
---
@@ -293,4 +293,19 @@ Delete publisher resources in the following order to make sure no orphaned resou
293293

294294
## Considerations if your NF runs cert-manager
295295

296-
TBD
296+
With release 1.0.2728-50 and later , AOSM now uses cert-manager to store and rotate certificates. As part of this change, AOSM deploys a cert-manager operator, and associate CRDs, in the azurehybridnetwork namespace. Since having multiple cert-manager operators, even deployed in separate namespaces, will watch across all namespaces, only one cert-manager can be effectively run on the cluster.
297+
298+
Any user trying to install cert-manager on the cluster, as part of a workload deployment, will get a deployment failure with an error that the CRD “exists and cannot be imported into the current release.” To avoid this error, the recommendation is to skip installing cert-manager, instead take dependency on cert-manager operator and CRD already installed by AOSM.
299+
300+
### Other Configuration Changes to Consider
301+
302+
In addition to disabling the NfApp associated with the old user cert-manager, we have found other changes may be needed;
303+
1. If any other NfApps have DependsOn references to the old user cert-manager NfApp, these will need to be removed.
304+
2. If any other NfApps reference the old user cert-manager namespace value, this will need to be changed to the new azurehybridnetwork namespace value.
305+
306+
### Cert-Manager Version Compatibility & Management
307+
308+
For the cert-manager operator, our current deployed version is 1.14.5. Users should test for compatibility with this version. Future cert-manager operator upgrades will be supported via the NFO extension upgrade process.
309+
310+
For the CRD resources, our current deployed version is 1.14.5. Users should test for compatibility with this version. Since management of a common cluster CRD is something typically handled by a cluster administrator, we are working to enable CRD resource upgrades via standard Nexus Add-on process.
311+

0 commit comments

Comments
 (0)