Merge pull request #3301 from itowlson/environment-definitions-starter-pack

Environment definitions starter pack

Author: itowlson

.github/workflows/publish-env-def.yml

@@ -0,0 +1,37 @@
+name: Publish environment definition to registry
+
+on:
+  workflow_dispatch:
+    inputs:
+      version:
+        description: "spin-up.(ver).toml version, e.g. 3.4, 3.5"
+        required: true
+        type: string
+
+jobs:
+  publish-env-def:
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+      packages: write
+      contents: write
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v3
+
+      - name: Install oras
+        uses: oras-project/setup-oras@v1
+
+      - name: Login to the GitHub registry
+        uses: docker/login-action@v3
+        with:
+          registry: ghcr.io
+          username: spinframeworkbot
+          password: ${{ secrets.SPIN_WIT_PAT }}
+
+      - name: Publish environment TOML
+        shell: bash
+        env:
+          VERSION: ${{ inputs.version }}
+        run: ./scripts/push-env-def.sh

scripts/push-env-def.sh

@@ -0,0 +1,4 @@
+#!/bin/bash
+set -euo pipefail 
+
+oras push ghcr.io/spinframework/environments/spin-up:$VERSION target-envs/spin-up.$VERSION.toml

target-envs/README.md

@@ -0,0 +1,14 @@
+# Spin target environments
+
+This folder contains target environment definitions for Spin. Each target
+environment is a TOML file which maps triggers to the WIT worlds supported by
+those triggers. When pushed to an OCI registry, these can be referenced
+in the Spin manifest `application.targets` array.
+
+Pushed environment definitions should not include the `.toml` extension
+and should be versioned using OCI versioning, e.g. `spin-up:3.4`
+We avoid using this convention for the source files because 1. syntax
+highlighting and 2. Windows filenames.
+
+Versions should include _minor version only_ because WITs should not
+change in patch releases.

target-envs/spin-up.3.2.toml

@@ -0,0 +1,7 @@
+default = { worlds = ["spin:up/[email protected]"] }
+
+[triggers]
+
+[triggers.http]
+worlds = ["spin:up/[email protected]"]
+capabilities = ["local_service_chaining"]

target-envs/spin-up.3.4.toml

@@ -0,0 +1,7 @@
+default = { worlds = ["spin:up/[email protected]"] }
+
+[triggers]
+
+[triggers.http]
+worlds = ["spin:up/[email protected]"]
+capabilities = ["local_service_chaining"]

target-envs/spin-up.3.5.toml

@@ -0,0 +1,7 @@
+default = { worlds = ["spin:up/[email protected]"] }
+
+[triggers]
+
+[triggers.http]
+worlds = ["spin:up/[email protected]", "spin:up/[email protected]"]
+capabilities = ["local_service_chaining"]