Part 3: Workload

What Will You Do¶

Create a K8s YAML workload that will deploy sample application with a hostname in our hosted zone and a service of Type LoadBalancer
Verify we can access the application via the LoadBalancer using the hostname

Step 1: Create Workload YAML¶

We are using a nginx deployment in this example to create a service of type LoadBalancer.

Copy the K8s YAML manifest below to a file called "nginx-lb.yaml"
Edit line 9 to a hostname for which an A record will be created in our hosted zone

apiVersion: v1
kind: Service
metadata:
  name: nginx
  annotations:
    external-dns.alpha.kubernetes.io/hostname: nginx-lb.dev.rafay-edge.net
spec:
  type: LoadBalancer
  ports:
  - port: 80
    name: http
    targetPort: 80
  selector:
    app: nginx
---
apiVersion: apps/v1
kind: Deployment
metadata:
  name: nginx
spec:
  selector:
    matchLabels:
      app: nginx
  template:
    metadata:
      labels:
        app: nginx
    spec:
      containers:
      - image: nginx
        name: nginx
        ports:
        - containerPort: 80
          name: http

Step 2: Create Workload¶

In this step, we will create a workload based on the YAML from the previous step and publish it to our cluster.

Click on Application -> Workloads
Click on "Create New Workload" with the name "nginx-lb"
Select "K8s YAML" for the Package Type
Select "Upload files manually" for Artifact Sync
Select the "external-dns" namespace from the dropdown
Click on "CONTINUE"

Create Workload

Select the file created in the previous step
Click on "SAVE AND GO TO PLACEMENT"

Create Workload

Set the Drift Action to "NotSet"
Select a cluster for the placement policy
Click on "SAVE AND GO TO PUBLISH"

Create Workload

Publish the workload

Create Workload

Step 3: Verify Workload¶

Click on the Kubectl button on the cluster to open a virtual terminal and run the following kubectl command

kubectl get services -n external-dns

NAME           TYPE           CLUSTER-IP       EXTERNAL-IP                                                               PORT(S)        AGE
external-dns   ClusterIP      10.100.217.116   <none>                                                                    7979/TCP       26m
nginx          LoadBalancer   10.100.42.70     a2dbcc64608e54a0d93f31b2cd3bfdee-1212175333.us-west-2.elb.amazonaws.com   80:31377/TCP   116s

Verify in Route 53 that the records have been properly created

Create Workload

Verify you can securely access the nginx app using your web browser and the newly created FQDN

Create Workload

Step 4: Unpublish Workload¶

In this step we will unpublish the workload and verify the Route 53 records are properly deleted

Click on Application -> Workloads
Click on the 3 dots of the nginx-lb workload
Select "Unpublish"

Unpublish Workload

You should see similar entries in the external-dns pod log showing that the records have been deleted

time="2023-06-06T05:27:49Z" level=info msg="Desired change: DELETE cname-nginx-lb.dev.rafay-edge.net TXT [Id: /hostedzone/Z1OM749F0P8E4R]"
time="2023-06-06T05:27:49Z" level=info msg="Desired change: DELETE nginx-lb.dev.rafay-edge.net A [Id: /hostedzone/Z1OM749F0P8E4R]"
time="2023-06-06T05:27:49Z" level=info msg="Desired change: DELETE nginx-lb.dev.rafay-edge.net TXT [Id: /hostedzone/Z1OM749F0P8E4R]"
time="2023-06-06T05:27:49Z" level=info msg="3 record(s) in zone dev.rafay-edge.net. [Id: /hostedzone/Z1OM749F0P8E4R] were successfully updated"

Verify in Route 53 that the records have been properly deleted

Create Workload

Recap¶

Congratulations!

You have successfully created a custom cluster blueprint with the "external-dns" add-on and applied it to a cluster. You have created a service of type LoadBalancer and properly created the corresponding Route 53 A record. You can now use this blueprint on as many clusters as you require.