Merge pull request #4 from Humanitec-DemoOrg/score-k8s

`score-k8s`

.devcontainer/devcontainer.json

@@ -4,7 +4,8 @@
  "features": {
  "ghcr.io/devcontainers/features/docker-in-docker:2": {
  "moby": true,
- "version": "latest"
+ "_comment": "cannot use latest for now because of this current issue: https://github.com/kubernetes-sigs/kind/issues/3696",
+ "version": "26.1.4" 
  },
  "ghcr.io/devcontainers/features/kubectl-helm-minikube:1": {
  "version": "latest",

.devcontainer/installMoreTools.sh

@@ -9,6 +9,12 @@ tar -xvf score-compose_${SCORE_COMPOSE_VERSION}_linux_amd64.tar.gz
 chmod +x score-compose
 sudo mv score-compose /usr/local/bin
 
+SCORE_K8S_VERSION=$(curl -sL https://api.github.com/repos/score-spec/score-k8s/releases/latest | jq -r .tag_name)
+wget https://github.com/score-spec/score-k8s/releases/download/${SCORE_K8S_VERSION}/score-k8s_${SCORE_K8S_VERSION}_linux_amd64.tar.gz
+tar -xvf score-k8s_${SCORE_K8S_VERSION}_linux_amd64.tar.gz
+chmod +x score-k8s
+sudo mv score-k8s /usr/local/bin
+
 HUMCTL_VERSION=$(curl -sL https://api.github.com/repos/humanitec/cli/releases/latest | jq -r .tag_name)
 curl -fLO https://github.com/humanitec/cli/releases/download/${HUMCTL_VERSION}/cli_${HUMCTL_VERSION:1}_linux_amd64.tar.gz
 tar -xvf cli_${HUMCTL_VERSION:1}_linux_amd64.tar.gz

.github/workflows/ci.yaml

@@ -9,7 +9,7 @@ jobs:
  strategy:
  matrix:
  apps: ["order", "product", "store-front", "makeline", "store-admin"]
- runs-on: ubuntu-22.04
+ runs-on: ubuntu-24.04
  env:
  HUMCTL_VERSION: '*'
  steps:
@@ -26,7 +26,7 @@ jobs:
  --org ${{ secrets.HUMANITEC_ORG }} \
  --strict
  score-compose:
- runs-on: ubuntu-22.04
+ runs-on: ubuntu-24.04
  env:
  SCORE_COMPOSE_VERSION: 'latest'
  steps:
@@ -40,4 +40,30 @@ jobs:
  version: ${{ env.SCORE_COMPOSE_VERSION }}
  - name: make compose-test
  run: |
- make compose-test
+ make compose-test
+ score-k8s:
+ runs-on: ubuntu-24.04
+ env:
+ SCORE_K8S_VERSION: 'latest'
+ steps:
+ - name: checkout code
+ uses: actions/checkout@v4
+ - name: install score-k8s
+ uses: score-spec/setup-score@v3
+ with:
+ file: score-k8s
+ token: ${{ secrets.GITHUB_TOKEN }}
+ version: ${{ env.SCORE_K8S_VERSION }}
+ - name: make kind-create-cluster
+ run: |
+ make kind-create-cluster
+ - name: make k8s-up
+ id: k8s-up
+ run: |
+ make k8s-up
+ - name: catch k8s-up errors
+ if: ${{ failure() && steps.k8s-up.outcome == 'failure' }}
+ run: |
+ kubectl get events
+ kubectl logs \
+ -l app.kubernetes.io/name=store-admin

.gitignore

@@ -1,3 +1,6 @@
 .score-compose/*
 !.score-compose/00-service.provisioners.yaml
 compose.yaml
+.score-k8s/*
+!.score-k8s/00-service.provisioners.yaml
+manifests.yaml

.score-k8s/00-service.provisioners.yaml

@@ -0,0 +1,7 @@
+- uri: template://service-provisioners/static-service
+ type: service
+ init: |
+ name: {{ splitList "." .Id | last }}
+ outputs: |
+ {{ $w := (index .WorkloadServices .Init.name) }}
+ name: {{ $w.ServiceName | quote }}

Makefile

@@ -37,6 +37,52 @@ compose-test: compose-up
 compose-down:
  docker compose down -v --remove-orphans || true
 
+.score-k8s/state.yaml:
+ score-k8s init \
+ --no-sample
+
+manifests.yaml: apps/makeline/score.yaml apps/order/score.yaml apps/product/score.yaml apps/store-admin/score.yaml apps/store-front/score.yaml .score-k8s/state.yaml Makefile
+ score-k8s generate \
+ apps/makeline/score.yaml \
+ apps/order/score.yaml \
+ apps/product/score.yaml \
+ apps/store-admin/score.yaml \
+ apps/store-front/score.yaml
+
+## Create a local Kind cluster.
+.PHONY: kind-create-cluster
+kind-create-cluster:
+ ./scripts/setup-kind-cluster.sh
+
+NAMESPACE ?= default
+## Generate a manifests.yaml file from the score spec and apply it in Kubernetes.
+.PHONY: k8s-up
+k8s-up: manifests.yaml
+ kubectl apply \
+ -f manifests.yaml \
+ -n ${NAMESPACE}
+ kubectl wait deployments/store-front \
+ -n ${NAMESPACE} \
+ --for condition=Available \
+ --timeout=90s
+ kubectl wait pods \
+ -n ${NAMESPACE} \
+ -l app.kubernetes.io/name=store-front \
+ --for condition=Ready \
+ --timeout=90s
+
+## Expose the container deployed in Kubernetes via port-forward.
+.PHONY: k8s-test
+k8s-test: k8s-up
+ curl $$(score-k8s resources get-outputs dns.default#store-front.dns --format '{{ .host }}')
+
+## Delete the deployment of the local container in Kubernetes.
+.PHONY: k8s-down
+k8s-down:
+ kubectl delete \
+ -f manifests.yaml \
+ -n ${NAMESPACE}
+
 ## Deploy the workloads to Humanitec.
 .PHONY: humanitec-deploy
 humanitec-deploy:

README.md

@@ -6,13 +6,24 @@ Get the [Azure-Samples/aks-store-demo](https://github.com/Azure-Samples/aks-stor
 
 ![](https://github.com/Azure-Samples/aks-store-demo/raw/main/assets/demo-arch.png)
 
-## Local deployment
+## Local deployment with Docker Compose
 
-You will need to [install `score-compose`](https://docs.score.dev/docs/score-implementation/score-compose/) locally.
-
-Deploy locally:
+Deploy and test locally with Docker compose:
 ```bash
 make compose-up
+
+make compose-test
+```
+
+## Local deployment with Kind cluster
+
+Deploy and test locally with Kind cluster:
+```bash
+make kind-create-cluster
+
+make k8s-up
+
+make k8s-test
 ```
 
 ## Humanitec deployment

scripts/setup-kind-cluster.sh

@@ -0,0 +1,35 @@
+#!/bin/bash
+set -o errexit
+
+cat <<EOF | kind create cluster --config=-
+kind: Cluster
+apiVersion: kind.x-k8s.io/v1alpha4
+nodes:
+- role: control-plane
+ extraPortMappings:
+ - containerPort: 31000
+ hostPort: 80
+ protocol: TCP
+EOF
+
+kubectl apply \
+ -f https://github.com/kubernetes-sigs/gateway-api/releases/download/v1.1.0/standard-install.yaml
+
+helm install ngf oci://ghcr.io/nginxinc/charts/nginx-gateway-fabric \
+ --create-namespace \
+ -n nginx-gateway \
+ --set service.type=NodePort \
+ --set-json 'service.ports=[{"port":80,"nodePort":31000}]'
+
+kubectl apply -f - <<EOF
+apiVersion: gateway.networking.k8s.io/v1
+kind: Gateway
+metadata:
+ name: default
+spec:
+ gatewayClassName: nginx
+ listeners:
+ - name: http
+ port: 80
+ protocol: HTTP
+EOF