-
Notifications
You must be signed in to change notification settings - Fork 638
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Adding in Kind specific install docs (#1643)
- Loading branch information
1 parent
1470779
commit e3e3da0
Showing
3 changed files
with
128 additions
and
1 deletion.
There are no files selected for viewing
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
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 |
---|---|---|
@@ -1,2 +1,2 @@ | ||
|
||
This Kubernetes Operator is meant to be deployed in your Kubernetes cluster(s) and can manage one or more AWX instances in any namespace. | ||
This Kubernetes Operator is meant to be deployed in your Kubernetes cluster(s) and can be used to install and manage the lifecycle of an AWX instance in the same namespace. |
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,125 @@ | ||
# AWX Operator on Kind | ||
|
||
## Kind Install | ||
|
||
Install Kind by running the following | ||
|
||
``` | ||
# For Intel Macs | ||
[ $(uname -m) = x86_64 ] && curl -Lo ./kind https://kind.sigs.k8s.io/dl/v0.20.0/kind-darwin-amd64 | ||
# For M1 / ARM Macs | ||
[ $(uname -m) = arm64 ] && curl -Lo ./kind https://kind.sigs.k8s.io/dl/v0.20.0/kind-darwin-arm64 | ||
chmod +x ./kind | ||
mv ./kind /some-dir-in-your-PATH/kind | ||
``` | ||
|
||
> https://kind.sigs.k8s.io/docs/user/quick-start/ | ||
|
||
### Create the Kind cluster | ||
|
||
Create a file called `kind.config` | ||
|
||
```yaml | ||
apiVersion: kind.x-k8s.io/v1alpha4 | ||
kind: Cluster | ||
nodes: | ||
- role: control-plane | ||
extraPortMappings: | ||
- containerPort: 32000 | ||
hostPort: 32000 | ||
listenAddress: "0.0.0.0" # Optional, defaults to "0.0.0.0" | ||
protocol: tcp # Optional, defaults to tcp | ||
- role: worker | ||
``` | ||
Then create a cluster using that config | ||
``` | ||
kind create cluster --config=kind.config | ||
``` | ||
|
||
Set cluster context for kubectl | ||
|
||
``` | ||
kubectl cluster-info --context kind-kind | ||
``` | ||
|
||
Install NGINX Ingress Controller | ||
|
||
``` | ||
kubectl apply -f https://raw.githubusercontent.com/kubernetes/ingress-nginx/main/deploy/static/provider/kind/deploy.yaml | ||
``` | ||
|
||
|
||
## AWX | ||
|
||
Set the namespace context | ||
|
||
``` | ||
kubectl config set-context --current --namespace=awx | ||
``` | ||
|
||
Checkout the tag you want to install from | ||
|
||
``` | ||
git checkout 2.7.2 | ||
``` | ||
|
||
Create a file named `kustomization.yaml` in the root of your local awx-operator clone. Include the following: | ||
|
||
``` | ||
apiVersion: kustomize.config.k8s.io/v1beta1 | ||
kind: Kustomization | ||
resources: | ||
# Find the latest tag here: https://github.com/ansible/awx-operator/releases | ||
- github.com/ansible/awx-operator/config/default?ref=2.7.2 | ||
# Set the image tags to match the git version from above | ||
images: | ||
- name: quay.io/ansible/awx-operator | ||
newTag: 2.7.2 | ||
# Specify a custom namespace in which to install AWX | ||
namespace: awx | ||
``` | ||
|
||
Run the following to apply the yaml | ||
|
||
``` | ||
kubectl apply -k . | ||
``` | ||
|
||
|
||
Create a file called `awx-cr.yaml` with the following contents and any configuration changes you may wish to add. | ||
|
||
``` | ||
--- | ||
apiVersion: awx.ansible.com/v1beta1 | ||
kind: AWX | ||
metadata: | ||
name: awx-demo | ||
spec: | ||
service_type: nodeport | ||
nodeport_port: 32000 | ||
``` | ||
|
||
Create your AWX CR | ||
|
||
``` | ||
oc create -f awx-cr.yaml | ||
``` | ||
|
||
Your AWX instance should now be reacheable at http://localhost:32000/ | ||
|
||
> If you configured a custom nodeport_port, you can find it by running `kubectl -n awx get svc awx-demo-service` | ||
|
||
|
||
## Cleanup | ||
|
||
When you are done, you can delete all of this by running | ||
|
||
``` | ||
kind delete cluster | ||
``` |