Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
26 commits
Select commit Hold shift + click to select a range
72226f4
feat: update Argo CD Gateway installation instructions and add Terraf…
ATGardner Mar 2, 2026
f6d8dc6
fixed lint errors
ATGardner Mar 2, 2026
5250c92
fixed spelling
ATGardner Mar 2, 2026
caaf0cb
fixed lint
ATGardner Mar 2, 2026
956467e
Update src/pages/docs/argo-cd/instances/terraform-bootstrap.md
ATGardner Mar 2, 2026
45df8a4
Update src/pages/docs/argo-cd/instances/terraform-bootstrap.md
ATGardner Mar 2, 2026
d581dcf
Update src/pages/docs/argo-cd/instances/terraform-bootstrap.md
ATGardner Mar 2, 2026
0bf6fc5
Update src/pages/docs/argo-cd/instances/terraform-bootstrap.md
ATGardner Mar 2, 2026
0f5f7e0
Update src/pages/docs/argo-cd/instances/terraform-bootstrap.md
ATGardner Mar 2, 2026
3f2a60e
Update src/pages/docs/argo-cd/instances/terraform-bootstrap.md
ATGardner Mar 2, 2026
e32d757
Update src/pages/docs/argo-cd/instances/terraform-bootstrap.md
ATGardner Mar 2, 2026
6435517
Update src/pages/docs/argo-cd/instances/terraform-bootstrap.md
ATGardner Mar 2, 2026
e7ebdec
Update src/pages/docs/argo-cd/instances/terraform-bootstrap.md
ATGardner Mar 2, 2026
6fb881d
Update src/pages/docs/argo-cd/instances/terraform-bootstrap.md
ATGardner Mar 2, 2026
db6f4fb
Update src/pages/docs/argo-cd/instances/terraform-bootstrap.md
ATGardner Mar 2, 2026
e03a9f8
Update src/pages/docs/argo-cd/instances/terraform-bootstrap.md
ATGardner Mar 2, 2026
55bf209
finxed lint
ATGardner Mar 2, 2026
0ccccc3
fix: update automated installation instructions for Argo CD Gateway
ATGardner Mar 2, 2026
09203cb
fix: update RBAC policy for Octopus user to include sync permissions
ATGardner Mar 3, 2026
b0678bb
fix: update Argo CD installation to use dedicated Octopus service acc…
ATGardner Mar 3, 2026
389d6bc
removed comment
ATGardner Mar 3, 2026
7990fd1
feat: deploy Octopus Argo CD Gateway as an Argo CD Application
ATGardner Mar 3, 2026
e5b2583
fixed lint
ATGardner Mar 3, 2026
8c763f3
fixed broken link
ATGardner Mar 3, 2026
0481e4b
fixed broken link
ATGardner Mar 3, 2026
71e954d
fix: update modification dates in documentation for consistency
ATGardner Mar 3, 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
2 changes: 1 addition & 1 deletion src/pages/docs/argo-cd/instances/argo-user.md
Original file line number Diff line number Diff line change
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
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
82 changes: 54 additions & 28 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-03
title: Automated Installation
description: Install Argo CD instances via scripting or IAC
navOrder: 10
Expand Down Expand Up @@ -117,30 +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):

```yaml
project: default
source:
repoURL: registry-1.docker.io/octopusdeploy
chart: octopus-argocd-gateway-chart
targetRevision: 1.3.0
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.18.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