Skip to content

📖 docs: Update argocd-agent solution to use clusteradm #1348

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
openshift-merge-bot merged 1 commit into from
Jan 29, 2026
Merged

📖 docs: Update argocd-agent solution to use clusteradm #1348

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 9 additions & 9 deletions solutions/argocd-agent/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -70,7 +70,7 @@ enabling efficient templating for deployment modifications.

## Prerequisites

- [Helm CLI](https://helm.sh/).
- [clusteradm CLI](https://open-cluster-management.io/docs/getting-started/quick-start/#install-clusteradm-cli-tool).

- Setup an OCM environment with at least two clusters (one hub and at least one managed).
Refer to the [Quick Start guide](https://open-cluster-management.io/docs/getting-started/quick-start/) for more details.
Expand All @@ -81,16 +81,13 @@ Refer to the [Additional Resources](#additional-resources) for more details.

## Setup Guide

### Deploy OCM Argo CD AddOn Managers on the Hub Cluster
### Deploy OCM Argo CD Agent AddOn on the Hub Cluster

```shell
# After OCM and load balancer setup:
#
# kubectl config use-context <hub-cluster>
helm repo add ocm https://open-cluster-management.io/helm-charts
helm repo update
helm search repo ocm
helm install argocd-agent-addon ocm/argocd-agent-addon --namespace argocd --create-namespace
clusteradm install hub-addon --names argocd-agent --create-namespace
```

Validate that the Argo CD Agent AddOn is successfully deployed and available:
Expand Down Expand Up @@ -170,9 +167,14 @@ spec:
EOF
```

then create the application on the **hub cluster**:
then create the target namespace on the managed cluster and the application on the **hub cluster**:

```shell
# Create the target namespace on the managed cluster
# kubectl config use-context <managed-cluster>
kubectl create namespace guestbook

# Create the application on the hub cluster
# kubectl config use-context <hub-cluster>
kubectl apply -f - <<EOF
apiVersion: argoproj.io/v1alpha1
Expand All @@ -190,8 +192,6 @@ spec:
server: https://172.18.255.200:443?agentName=cluster1 # Replace with https://<principal-external-ip:port>?agentName=<managed-cluster-name>
namespace: guestbook
syncPolicy:
syncOptions:
- CreateNamespace=true
automated:
prune: true
EOF
Expand Down