Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
32 commits
Select commit Hold shift + click to select a range
ae38ce7
feat: update Argo CD Gateway installation instructions and add Terraf…
ATGardner Mar 2, 2026
2acb55c
fixed lint errors
ATGardner Mar 2, 2026
42bca96
fixed spelling
ATGardner Mar 2, 2026
834b171
fixed lint
ATGardner Mar 2, 2026
1fdbafe
Update src/pages/docs/argo-cd/instances/terraform-bootstrap.md
ATGardner Mar 2, 2026
61f1399
Update src/pages/docs/argo-cd/instances/terraform-bootstrap.md
ATGardner Mar 2, 2026
50c465b
Update src/pages/docs/argo-cd/instances/terraform-bootstrap.md
ATGardner Mar 2, 2026
b2c50dd
Update src/pages/docs/argo-cd/instances/terraform-bootstrap.md
ATGardner Mar 2, 2026
831463f
Update src/pages/docs/argo-cd/instances/terraform-bootstrap.md
ATGardner Mar 2, 2026
a63609c
Update src/pages/docs/argo-cd/instances/terraform-bootstrap.md
ATGardner Mar 2, 2026
3776adc
Update src/pages/docs/argo-cd/instances/terraform-bootstrap.md
ATGardner Mar 2, 2026
060470c
Update src/pages/docs/argo-cd/instances/terraform-bootstrap.md
ATGardner Mar 2, 2026
4c1cb64
Update src/pages/docs/argo-cd/instances/terraform-bootstrap.md
ATGardner Mar 2, 2026
0fa650a
Update src/pages/docs/argo-cd/instances/terraform-bootstrap.md
ATGardner Mar 2, 2026
06aa336
Update src/pages/docs/argo-cd/instances/terraform-bootstrap.md
ATGardner Mar 2, 2026
9ff226f
Update src/pages/docs/argo-cd/instances/terraform-bootstrap.md
ATGardner Mar 2, 2026
03a691e
finxed lint
ATGardner Mar 2, 2026
99e2383
fix: update automated installation instructions for Argo CD Gateway
ATGardner Mar 2, 2026
bfce240
fix: update RBAC policy for Octopus user to include sync permissions
ATGardner Mar 3, 2026
243f1d9
fix: update Argo CD installation to use dedicated Octopus service acc…
ATGardner Mar 3, 2026
5fd75ba
removed comment
ATGardner Mar 3, 2026
aba0a89
feat: deploy Octopus Argo CD Gateway as an Argo CD Application
ATGardner Mar 3, 2026
d03e920
fixed lint
ATGardner Mar 3, 2026
46c1532
fixed broken link
ATGardner Mar 3, 2026
ffc6d01
fixed broken link
ATGardner Mar 3, 2026
b4c661f
fix: update modification dates in documentation for consistency
ATGardner Mar 3, 2026
b459bb5
updated dates
ATGardner Mar 26, 2026
c385e4a
fixed terraform example chart_version
ATGardner Mar 26, 2026
735354c
fix: rename example files from .yaml to .tf for consistency
ATGardner Mar 26, 2026
7d2e865
fix: update Argo CD installation instructions and remove unused varia…
ATGardner Mar 30, 2026
4344923
fixed lint
ATGardner Mar 30, 2026
29add35
fixed broken link
ATGardner Mar 30, 2026
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
4 changes: 2 additions & 2 deletions src/pages/docs/argo-cd/instances/argo-user.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
layout: src/layouts/Default.astro
pubDate: 2025-09-15
modDate: 2026-03-09
modDate: 2026-03-26
title: Argo CD Authentication
description: Limiting Octopus's access in Argo CD
navOrder: 10
Expand Down Expand Up @@ -62,7 +62,7 @@ With the user created, an RBAC policy must be created allowing the new user to a

The RBAC policies are stored within the `argocd-rbac-cm` configmap.

The following shows an Octopus user which has read only access to all applications, cluster and log data.
The following shows an Octopus user which has read only access to all applications, cluster and log data, and sync permissions for applications.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can you also update the modDate for this file please 🙇


```yaml
apiVersion: v1
Expand Down
84 changes: 54 additions & 30 deletions src/pages/docs/argo-cd/instances/automated-installation.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
layout: src/layouts/Default.astro
pubDate: 2025-09-15
modDate: 2026-01-20
modDate: 2026-03-26
title: Automated Installation
description: Install Argo CD instances via scripting or IAC
navOrder: 10
Expand Down Expand Up @@ -117,32 +117,56 @@ The Octopus-Argo Gateway's helm chart can be installed via an Argo CD Applicatio

The application YAML required to install the helm chart is as follows (replacing values as per previous examples):

Update `targetRevision` to the most recent tag found on [dockerhub](https://hub.docker.com/r/octopusdeploy/octopus-argocd-gateway-chart)

```yaml
project: default
source:
repoURL: registry-1.docker.io/octopusdeploy
chart: octopus-argocd-gateway-chart
targetRevision: <helm chart version>
helm:
parameters:
- name: registration.octopus.name
value: <display name of gateway in Octopus>
- name: registration.octopus.serverAccessToken
value: API-XXXXXXXXXXXXXXXX
- name: registration.octopus.serverApiUrl
value: https://your-instance.octopus.app
- name: registration.octopus.spaceId
value: Spaces-1
- name: gateway.argocd.authenticationToken
value: >-
<Argo Api Token>
- name: gateway.argocd.serverGrpcUrl
value: grpc://argocd-server.argocd.svc.cluster.local"
- name: gateway.octopus.serverGrpcUrl
value: grpc://your-instance.octopus.app:8443
destination:
server: https://kubernetes.default.svc
namespace: octopus-argo-gateway-your-namespace
```
1. Create the namespace

```shell
kubectl create ns octopus-argo-gateway-your-namespace
```

2. Generate Argo CD Authentication Token
2.1. Follow the instructions on the [Argo CD Authentication](/docs/argo-cd/instances/argo-user) guide
2.2. Save the token in a secret

```shell
kubectl create secret generic argocd-auth-token -n octopus-argo-gateway-your-namespace --from-literal=ARGOCD_AUTH_TOKEN=<token>
```

3. Generate Octopus Deploy Api-Key
3.1. Follow the instreuctions on the [How to Create an API Key](/docs/octopus-rest-api/how-to-create-an-api-key) guide
3.2. Save the token in a secret

```shell
kubectl create secret generic octopus-server-access-token -n octopus-argo-gateway-your-namespace --from-literal=OCTOPUS_SERVER_ACCESS_TOKEN=<token>
```

4. Apply the Argo CD application (or commit this manifest to your git-ops repository already synced by Argo CD)

```yaml
project: default
source:
repoURL: registry-1.docker.io/octopusdeploy
chart: octopus-argocd-gateway-chart
targetRevision: 1.23.0
helm:
valuesObject:
registration:
octopus:
name: <display name of gateway in Octopus>
serverApiUrl: https://your-instance.octopus.app
serverAccessTokenSecretName: octopus-server-access-token
serverAccessTokenSecretKey: OCTOPUS_SERVER_ACCESS_TOKEN
spaceId: Spaces-1
gateway:
octopus:
serverGrpcUrl: grpc://your-instance.octopus.app:8443
argocd:
serverGrpcUrl: grpc://argocd-server.argocd.svc.cluster.local
authenticationTokenSecretName: argocd-auth-token
authenticationTokenSecretKey: ARGOCD_AUTH_TOKEN
autoUpdate:
# should be disabled, otherwise the auto-update job will keep trying to update the instance, while argo cd syncs it back to original state
enabled: false
destination:
server: https://kubernetes.default.svc
namespace: octopus-argo-gateway-your-namespace
```
Loading
Loading