contour-development

Files (1)

• SKILL.md

SKILL.md (first lines)

# Contour Development

**Required: this skill depends on the `kind` and `runagent` skills. Load the `kind` and `runagent` skills together with this one, every time, even if the task is only to read this skill.**

Verify working directory before any task:

```bash
test -f go.mod && grep -q 'module github.com/projectcontour/contour' go.mod && echo "OK" || echo "NOT in Contour root"
```

---

## Kind Cluster

Create and access cluster `contour` at `127.0.0.101`, hostnames `*.127-0-0-101.nip.io`. `HOST_IP` below is the host as seen from pods.

Install Contour:

```bash
kubectl apply -f https://projectcontour.io/quickstart/contour.yaml
kubectl -n projectcontour wait --for=condition=available --timeout=300s deployment/contour
kubectl -n projectcontour wait --for=condition=ready --timeout=300s pod -l app=envoy
```


To use the latest unreleased development build from `main` branch use

```bash
kubectl apply -f https://raw.githubusercontent.com/projectcontour/contour/main/examples/render/contour.yaml
```

---

## Deploy Echoserver

Use [Echoserver](https://github.com/tsaarni/echoserver) as upstream / backedn service.

```bash
kubectl apply -f - <<EOF
apiVersion: apps/v1
kind: Deployment
metadata:
  name: echoserver
spec:
  selector:
    matchLabels:
      app: echoserver
  template:
    metadata:
      labels:
        app: echoserver
    spec:
      containers:
      - name: echoserver
        image: ghcr.io/tsaarni/echoserver:latest
        env:
        - name: ENV_POD_NAME
          valueFrom:
            fieldRef:
              fieldPath: metadata.name
        - name: ENV_NAMESPACE
          valueFrom:
            fieldRef:
              fieldPath: metadata.namespace
        - name: ENV_POD_IP
          valueFrom:
            fieldRef:
              fieldPath: status.podIP
        - name: ENV_NODE_NAME
          valueFrom:
            fieldRef:
              fieldPath: spec.nodeName
        - name: ENV_POD_UID
          valueFrom:
            fieldRef:
              fieldPath: metadata.uid
        ports:
        - name: http-api
          containerPort: 8080
        - name: https-api
          containerPort: 8443
---
apiVersion: v1
kind: Service
metadata:
  name: echoserver
spec:
  ports:
  - name: http
    port: 80
    targetPort: http-api
  - name: http2
    port: 443
    targetPort: https-api
  selector:
    app: echoserver
---
apiVersion: projectcontour.io/v1
kind: HTTPProxy
metadata:
  name: echoserver
spec:
  virtualhost:
    fqdn: echoserver.127-0-0-101.nip.io
  routes:
    - services:
        - name: echoserver
          port: 80
EOF

kubectl wait --for=condition=ready --timeout=300s pod -l app=echoserver
```

---

## Run Contour from Source on Host Against Kind Cluster

Point Service `contour` in namespace `projectcontour`, port `8001`, at the host so Envoy connects to Contour running there. This replaces the in-cluster Service.

From tsaarni/agent-skills, Apache-2.0.

More from tsaarni/agent-skills