App image

.dockerignore

@@ -1,8 +1,10 @@
 .git
+.github
 
 **/__pycache__
 .trunk
 .venv
+.envrc
 build
 dist
 **/*.egg-info

.github/workflows/deploy-app.yml

@@ -0,0 +1,91 @@
+name: Publish Warnet app bundle image
+on:
+  push:
+    branches:
+      - main
+    tags:
+      - '*'
+  pull_request:
+    branches:
+      - main
+env:
+  REGISTRY_IMAGE: ${{ secrets.DOCKERHUB_USERNAME }}/warnet-app
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        platform:
+          - linux/amd64
+          - linux/arm64
+    steps:
+      - name: Prepare
+        run: |
+          platform=${{ matrix.platform }}
+          echo "PLATFORM_PAIR=${platform//\//-}" >> $GITHUB_ENV
+      - name: Docker meta
+        id: meta
+        uses: docker/metadata-action@v5
+        with:
+          images: ${{ env.REGISTRY_IMAGE }}
+      - name: Set up QEMU
+        uses: docker/setup-qemu-action@v3
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+      - name: Login to Docker Hub
+        uses: docker/login-action@v3
+        with:
+          username: ${{ secrets.DOCKERHUB_USERNAME }}
+          password: ${{ secrets.DOCKERHUB_TOKEN }}
+      - name: Build and push by digest
+        id: build
+        uses: docker/build-push-action@v6
+        with:
+          file: resources/images/warnet-bundle/Dockerfile
+          platforms: ${{ matrix.platform }}
+          labels: ${{ steps.meta.outputs.labels }}
+          outputs: type=image,name=${{ env.REGISTRY_IMAGE }},push-by-digest=true,name-canonical=true,push=true
+      - name: Export digest
+        run: |
+          mkdir -p /tmp/digests
+          digest="${{ steps.build.outputs.digest }}"
+          touch "/tmp/digests/${digest#sha256:}"
+      - name: Upload digest
+        uses: actions/upload-artifact@v4
+        with:
+          name: digests-${{ env.PLATFORM_PAIR }}
+          path: /tmp/digests/*
+          if-no-files-found: error
+          retention-days: 1
+  merge:
+    runs-on: ubuntu-latest
+    needs:
+      - build
+    steps:
+      - name: Download digests
+        uses: actions/download-artifact@v4
+        with:
+          path: /tmp/digests
+          pattern: digests-*
+          merge-multiple: true
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+      - name: Docker meta
+        id: meta
+        uses: docker/metadata-action@v5
+        with:
+          images: ${{ env.REGISTRY_IMAGE }}
+      - name: Login to Docker Hub
+        uses: docker/login-action@v3
+        with:
+          username: ${{ vars.DOCKERHUB_USERNAME }}
+          password: ${{ secrets.DOCKERHUB_TOKEN }}
+      - name: Create manifest list and push
+        working-directory: /tmp/digests
+        run: |
+          docker buildx imagetools create $(jq -cr '.tags | map("-t " + .) | join(" ")' <<< "$DOCKER_METADATA_OUTPUT_JSON") \
+            $(printf '${{ env.REGISTRY_IMAGE }}@sha256:%s ' *)
+      - name: Inspect image
+        run: |
+          docker buildx imagetools inspect ${{ env.REGISTRY_IMAGE }}:${{ steps.meta.outputs.version }}

.github/workflows/test.yml

@@ -16,59 +16,39 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
-      - uses: eifinger/setup-uv@v1
-      - run: uvx ruff check .
+      - name: Install a specific version of uv
+        uses: astral-sh/setup-uv@v3
+        with:
+          version: "0.4.4"
+          enable-cache: true
+      - run: uvx [email protected] check .
 
   ruff-format:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
-      - name: Install the latest version of uv
-        uses: astral-sh/setup-uv@v2
+      - name: Install a specific version of uv
+        uses: astral-sh/setup-uv@v3
         with:
-          version: "latest"
+          version: "0.4.4"
           enable-cache: true
-      - run: uvx ruff format . --check
-
-  build-image:
-    needs: [ruff, ruff-format]
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Set up Docker Buildx
-        uses: docker/setup-buildx-action@v3
-
-      - name: Build and export
-        uses: docker/build-push-action@v5
-        with:
-          file: resources/images/commander/Dockerfile
-          context: .
-          tags: bitcoindevproject/warnet-commander:latest
-          cache-from: type=gha
-          cache-to: type=gha,mode=max
-          outputs: type=docker,dest=/tmp/commander.tar
-
-      - name: Upload artifact
-        uses: actions/upload-artifact@v4
-        with:
-          name: commander
-          path: /tmp/commander.tar
+      - run: uvx [email protected] format . --check
 
   test:
-    needs: [build-image]
+    needs: [ruff, ruff-format]
     runs-on: ubuntu-latest
     strategy:
       matrix:
         test:
           - conf_test.py
           - dag_connection_test.py
+          - graph_test.py
           - logging_test.py
           - rpc_test.py
           - services_test.py
           - signet_test.py
           - scenarios_test.py
+          - namespace_admin_test.py
     steps:
       - uses: actions/checkout@v4
       - uses: azure/[email protected]
@@ -78,11 +58,8 @@ jobs:
         with:
           cpus: max
           memory: 4000m
-      - name: Download commander artifact
-        uses: actions/download-artifact@v4
-        with:
-          name: commander
-          path: /tmp
+      - name: Start minikube's loadbalancer tunnel
+        run: minikube tunnel &> /dev/null &
       - name: Install the latest version of uv
         uses: astral-sh/setup-uv@v2
         with:
@@ -92,12 +69,6 @@ jobs:
         run: uv python install $PYTHON_VERSION
       - name: Install project
         run: uv sync --all-extras --dev
-      - name: Install commander image
-        run: |
-          echo loading commander image into minikube docker
-          eval $(minikube -p minikube docker-env)
-          docker load --input /tmp/commander.tar
-          docker image ls -a
       - name: Run tests
         run: |
           source .venv/bin/activate
@@ -122,24 +93,3 @@ jobs:
           name: kubernetes-logs-${{ matrix.test }}
           path: ./k8s-logs
           retention-days: 5
-  test-without-mk:
-    runs-on: ubuntu-latest
-    strategy:
-      matrix:
-        test:
-          - graph_test.py
-    steps:
-      - uses: actions/checkout@v4
-      - name: Install the latest version of uv
-        uses: astral-sh/setup-uv@v2
-        with:
-          version: "latest"
-          enable-cache: true
-      - name: Install Python
-        run: uv python install $PYTHON_VERSION
-      - name: Install project
-        run: uv sync --all-extras --dev
-      - name: Run tests
-        run: |
-          source .venv/bin/activate
-          ./test/${{matrix.test}}

.gitignore

@@ -6,3 +6,4 @@ warnet.egg-info
 .env
 dist/
 build/
+**/kubeconfigs/

docs/admin.md

@@ -0,0 +1,69 @@
+# Admin
+
+## Connect to your cluster
+
+Ensure you are connected to your cluster because Warnet will use your current configuration to generate configurations for your users.
+
+```shell
+$ warnet status
+```
+
+Observe that the output of the command matches your cluster.
+
+## Create an *admin* directory
+
+```shell
+$ mkdir admin
+$ cd admin
+$ warnet admin init
+```
+
+Observe that there are now two folders within the *admin* directory: *namespaces* and *networks*
+
+## The *namespaces* directory
+This directory contains a Helm chart named *two_namespaces_two_users*.
+
+Modify this chart based on the number of teams and users you have.
+
+Deploy the *two_namespaces_two_users* chart.
+
+```shell
+$ warnet deploy namespaces/two_namespaces_two_users
+```
+
+Observe that this creates service accounts and namespaces in the cluster:
+
+```shell
+$ kubectl get ns
+$ kubectl get sa -A
+```
+
+### Creating Warnet invites
+A Warnet invite is a Kubernetes config file.
+
+Create invites for each of your users.
+
+```shell
+$ warnet admin create-kubeconfigs
+```
+
+Observe the *kubeconfigs* directory. It holds invites for each user.
+
+### Using Warnet invites
+Users can connect to your wargame using their invite.
+
+```shell
+$ warnet auth alice-wargames-red-team-kubeconfig
+```
+
+### Set up a network for your users
+Before letting the users into your cluster, make sure to create a network of tanks for them to view.
+
+
+```shell
+$ warnet deploy networks/mynet --to-all-users
+```
+
+Observe that the *wargames-red-team* namespace now has tanks in it.
+
+**TODO**: What's the logging approach here?