forked from ansible/awx-operator
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Moved Adding Execution Nodes to its own section.
- Loading branch information
Showing
2 changed files
with
26 additions
and
27 deletions.
There are no files selected for viewing
26 changes: 26 additions & 0 deletions
26
docs/user-guide/advanced-configuration/adding-execution-nodes.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,26 @@ | ||
### Adding Execution Nodes | ||
Starting with AWX Operator v0.30.0 and AWX v21.7.0, standalone execution nodes can be added to your deployments. | ||
See [AWX execution nodes docs](https://github.com/ansible/awx/blob/devel/docs/execution_nodes.md) for information about this feature. | ||
|
||
#### Custom Receptor CA | ||
The control nodes on the K8S cluster will communicate with execution nodes via mutual TLS TCP connections, running via Receptor. | ||
Execution nodes will verify incoming connections by ensuring the x509 certificate was issued by a trusted Certificate Authority (CA). | ||
|
||
A user may wish to provide their own CA for this validation. If no CA is provided, AWX Operator will automatically generate one using OpenSSL. | ||
|
||
Given custom `ca.crt` and `ca.key` stored locally, run the following, | ||
|
||
```bash | ||
kubectl create secret tls awx-demo-receptor-ca \ | ||
--cert=/path/to/ca.crt --key=/path/to/ca.key | ||
``` | ||
|
||
The secret should be named `{AWX Custom Resource name}-receptor-ca`. In the above the AWX CR name is "awx-demo". Please replace "awx-demo" with your AWX Custom Resource name. | ||
|
||
If this secret is created after AWX is deployed, run the following to restart the deployment, | ||
|
||
```bash | ||
kubectl rollout restart deployment awx-demo | ||
``` | ||
|
||
**Important Note**, changing the receptor CA will break connections to any existing execution nodes. These nodes will enter an `unavailable` state, and jobs will not be able to run on them. Users will need to download and re-run the install bundle for each execution node. This will replace the TLS certificate files with those signed by the new CA. The execution nodes should then appear in a `ready` state after a few minutes. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters