infra/deploy/huly/QUICKSTART.md

Quick Start with Kind

Note

kind does not require kubectl, but you will not be able to perform some of the examples in our docs without it. To install kubectl see the upstream kubectl installation docs.

Install

macOS:

# For Intel Macs
[ $(uname -m) = x86_64 ] && curl -Lo ./kind https://kind.sigs.k8s.io/dl/v0.26.0/kind-darwin-amd64
# For M1 / ARM Macs
[ $(uname -m) = arm64 ] && curl -Lo ./kind https://kind.sigs.k8s.io/dl/v0.26.0/kind-darwin-arm64
chmod +x ./kind
mv ./kind /some-dir-in-your-PATH/kind

Linux:

# For AMD64 / x86_64
[ $(uname -m) = x86_64 ] && curl -Lo ./kind https://kind.sigs.k8s.io/dl/v0.26.0/kind-linux-amd64
# For ARM64
[ $(uname -m) = aarch64 ] && curl -Lo ./kind https://kind.sigs.k8s.io/dl/v0.26.0/kind-linux-arm64
chmod +x ./kind
sudo mv ./kind /usr/local/bin/kind

Setup cluster with port forwarding

Note

On the host computer, localhost:80 should be accessible.

cat <<EOF | kind create cluster --config=-
kind: Cluster
apiVersion: kind.x-k8s.io/v1alpha4
nodes:
- role: control-plane
  extraPortMappings:
  - containerPort: 80
    hostPort: 80
    protocol: TCP
  - containerPort: 443
    hostPort: 443
    protocol: TCP
EOF

Deploy the ingress nginx controller:

kubectl apply -f https://kind.sigs.k8s.io/examples/ingress/deploy-ingress-nginx.yaml

Wait the nginx controller to be ready:

kubectl wait --namespace ingress-nginx \
  --for=condition=ready pod \
  --selector=app.kubernetes.io/component=controller \
  --timeout=90s

Add host entries to be able to work with ingresses from the host machine:

sudo cp -p /etc/hosts /tmp/hosts
echo "127.0.0.1       huly.example" | sudo tee -a /etc/hosts
echo "127.0.0.1       account.huly.example" | sudo tee -a /etc/hosts

Deploy Huly with kubectl:

kubectl apply -R -f .

Wait until the front app is coming up:

kubectl wait --for=condition=Avaiable deployment/front --timeout 3m

Now, launch your web and and (enjoy Huly!)[http://huly.example]!

Cleanup

Restore hosts file:

sudo mv /tmp/hosts /etc/hosts

Cleanup Huly:

kubectl delete -R -f .

Delete kind cluster:

kind delete cluster