Update README

This commit is contained in:
Victor Timofei 2021-12-31 15:06:05 +02:00
parent 0610e0a439
commit 8685876b3a
Signed by: vtimofei
GPG Key ID: B790DCEBE281403A
1 changed files with 136 additions and 2 deletions

138
README.md
View File

@ -3,16 +3,150 @@ Kubernetes Digital Ocean Challenge
[Deploy a GitOps CI/CD implementation](https://www.digitalocean.com/community/pages/kubernetes-challenge#anchor--challenges)
## Installation:
## Installation
Run the `install.sh` script, which will install Helm, Nginx Ingress controller, ArgoCD, and tekton.
```sh
./install.sh
```
Update the DNS records to point to the load balancer.
Install cert-manager and create Ingress for ArgoCD.
```sh
DOMAIN=my.domain EMAIL_ADDRESS=victor@my.domain ./install-cert-manager.sh
```
## Create the pipeline
To create the pipeline fork the `https://github.com/victor-timofei/tekton-example-pipeline` repo.
You should also fork the application repo `https://github.com/victor-timofei/tekton-pipeline-example-app`.
Create the secrets inside the `tekton-pipeline/resources/secrets` directory.
You can get the ArgoCD admin password by running the `get-argocd-admin-password.sh` script from
this repo.
For the docker password you can create an [access token](https://hub.docker.com/settings/security) if you are using docker hub.
For the github password you should use the [personal access token](https://github.com/settings/tokens).
```sh
cat << EOF > argocd_secrets.env
ARGOCD_USERNAME=admin
ARGOCD_PASSWORD=<admin_password>
EOF
cat << EOF > docker_secrets.env
username=<service_principal_id>
password=<service_principal_password>
EOF
cat << EOF > git_app_secrets.env
username=<username>
password=<personal_access_token>
EOF
```
Edit the `ARGOCD_SERVER` in `tekton-pipeline/resources/argocd-task-cm.yaml` with your ArgoCD
server address:
```yaml
ARGOCD_SERVER: argocd.k8s-argocd.tk
```
Edit the git and docker url in `tekton-pipeline/resources/secrets.yaml`:
```yaml
tekton.dev/git-0: https://github.com/victor-timofei/tekton-pipeline-example-app
...
tekton.dev/docker-0: registry.hub.docker.com
```
Edit the `DOCKER_IMAGE_NAME` and `DOCKER_NAMESPACE` in `tekton-pipeline/resources/secrets.yaml`.
Since I was using docker hub, the docker namespace was my username.
```yaml
DOCKER_IMAGE_NAME: hello-app
DOCKER_NAMESPACE: vtimofei
```
Edit the docker registry name in the `tekton-pipeline/triggers/trigger-template.yaml`.
```yaml
spec:
params:
- name: url
# Replace <docker_registry_name> with your docker registry name (e.g. my-acr.azurecr.io)
value: registry.hub.docker.com
```
Edit the trigger binding params in `tekton-pipeline/triggers/trigger-binding.yaml`.
These are extracted from the GitHub request webhook, depending on your git hosting service the
request schema might be different.
```yaml
spec:
params:
- name: git-app-repo-url
value: $(body.repository.url)
- name: git-app-repo-revision
value: $(body.repository.default_branch)
```
Set your own address on the certficates and ingresses.
Edit the `tekton-pipeline/triggers/certficate.yaml` on the `tekton-example-pipeline` repo and
`kustomize/certficate.yaml` on the `tekton-pipeline-example-app` repo.
```yaml
dnsNames:
- k8s-argocd.tk
```
Edit the `tekton-pipeline/triggers/ingress.yaml` on the `tekton-example-pipeline` repo and
`kustomize/ingress.yaml` on the `tekton-pipeline-example-app` repo.
```yaml
dnsNames:
- k8s-argocd.tk
...
tls:
- hosts:
- k8s-argocd.tk
```
## Add the pipeline to ArgoCD
Login to argocd via the CLI:
```sh
argocd login argocd.k8s-argocd.tk
```
You might want to add the argocd binary that was downloaded via the install script to your path.
You can do it easily with:
```sh
source env
```
Add your cluster to ArgoCD:
```sh
argocd cluster add do-fra1-k8s-challenge
```
Create the pipeline secretes:
```sh
kubectl apply -k tekton-pipeline/resources/.
```
Register your git repos with ArgoCD:
```sh
export SCM_USERNAME=<git_repo_username>
export SCM_PAT=<git_repo_personal_access_token>
argocd repo add <pipeline_repo_url> --username $SCM_USERNAME --password $SCM_PAT
argocd repo add <app_repo_url> --username $SCM_USERNAME --password $SCM_PAT
```
Create the ArgoCD applications:
```sh
argocd app create tekton-pipeline-app --repo <pipeline_repo_url> --path tekton-pipeline --dest-server https://kubernetes.default.svc --dest-namespace tekton-argocd-example
argocd app create 2048-game-app --repo <app_repo> --path kustomize --dest-server https://kubernetes.default.svc --dest-namespace game-2048 --sync-option CreateNamespace=true
```
Sync the tekton pipeline:
```sh
argocd app sync tekton-pipeline-app --prune
```
Register the tekton webhook with your git provider. The webhook should be like `https://k8s-argocd.tk/tekton-argocd-example-build-webhook`.
Now you everytime you push to your default application branch the pipeline is triggered, your
application is built and push to the container registry and finally it is deployed.