kestra-io / kestra-io/docs

Azure AKS UI should be simplified

Open
#2,242 3 comments 0 reactions 0 assignees View on GitHub
area/devops area/docs
Dominant language
Astro
Stars
155
Forks
177
Avg merge
1d 20m
Merged PRs (30d)
192

Description

### Describe what's missing in our docs

In [this section](https://kestra.io/docs/installation/kubernetes-azure-aks#access-kestra-ui) we tell the end user that they must deploy an Azure Application Gateway in order to configure access to the UI.

This is not user-friendly as the configuration for an Application Gateway is quite complex. I would propose dropping this as for users coming to Kestra on AKS for the first time it would be easier to suggest deploying either a load balancer directly on the cluster or to just port-forward.

E.g. load balancer
```
# Create the file
cat << EOF >> loadbalancer.yaml
apiVersion: v1
kind: Service
metadata:
name: kestra-webserver
spec:
selector:
app.kubernetes.io/component: webserver
ports:
- protocol: TCP
port: 80 # This is the port exposed by the service (you can change it if needed)
targetPort: 8080 # This is the port your web server is listening on inside the pod
type: LoadBalancer # This exposes the service externally via a cloud LoadBalancer
EOF

# create the service
kubectl apply -f loadbalancer.yaml
```

Contributor guide

Open the contributing guide

Research direction

Start with the “Access Kestra UI” section in the Azure AKS installation documentation linked in the issue. Review the existing Application Gateway guidance and the proposed LoadBalancer and port-forward alternatives, then update the section so the simpler access options are documented and verify the YAML and kubectl commands are accurate.

Written by the indexing model from the issue text.

Assessment

Tech stack
azure, kubernetes
Domain
cloud, devops, documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
52/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.