From b3b5cdc3fbf58f81daa59779de305853a49f2501 Mon Sep 17 00:00:00 2001 From: metal-stack Date: Thu, 30 Nov 2023 14:24:39 +0000 Subject: [PATCH 1/2] Bump releases to version v0.15.13 --- Makefile | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Makefile b/Makefile index 5a222c8715..cd4ce9b1a1 100644 --- a/Makefile +++ b/Makefile @@ -1,5 +1,5 @@ .DEFAULT_GOAL := build -RELEASE_VERSION := $(or ${RELEASE_VERSION},"v0.15.11") +RELEASE_VERSION := $(or ${RELEASE_VERSION},"v0.15.13") ifeq ($(CI),true) DOCKER_TTY_ARG= From 83c8f30ba46cc46a70f4d0778931b552e951906b Mon Sep 17 00:00:00 2001 From: auto-build Date: Thu, 30 Nov 2023 14:26:38 +0000 Subject: [PATCH 2/2] Auto generate --- docs/src/external/mini-lab/README.md | 34 ++++++++++++---------------- 1 file changed, 14 insertions(+), 20 deletions(-) diff --git a/docs/src/external/mini-lab/README.md b/docs/src/external/mini-lab/README.md index 283f132810..4ee5c40133 100644 --- a/docs/src/external/mini-lab/README.md +++ b/docs/src/external/mini-lab/README.md @@ -21,10 +21,9 @@ The mini-lab is a small, virtual setup to locally run the metal-stack. It deploy - Linux machine with hardware virtualization support - kvm as hypervisor for the VMs (you can check through the `kvm-ok` command) -- [docker](https://www.docker.com/) >= 18.09 (for using kind and our deployment base image) -- [docker-compose](https://docs.docker.com/compose/) >= 2.0 (for ease of use and for parallelizing control plane and partition deployment) -- [kind](https://github.com/kubernetes-sigs/kind/releases) == v0.15.0 (for hosting the metal control plane on a kubernetes cluster v1.25) -- [containerlab](https://containerlab.srlinux.dev/install/) == v0.25.1 +- [docker](https://www.docker.com/) >= 20.10.13 (for using kind and our deployment base image) +- [kind](https://github.com/kubernetes-sigs/kind/releases) == v0.20.0 (for hosting the metal control plane) +- [containerlab](https://containerlab.srlinux.dev/install/) >= v0.47.1 - the lab creates a docker network on your host machine (`172.17.0.1`), this hopefully does not overlap with other networks you have - (recommended) haveged to have enough random entropy (only needed if the PXE process does not work) @@ -49,17 +48,12 @@ curl -fsSL https://get.docker.com | sh sudo usermod -G docker -a ${USER} # Install containerlab -bash -c "$(curl -sL https://get.containerlab.dev)" -- -v 0.25.1 +bash -c "$(curl -sL https://get.containerlab.dev)" # Install kind (kubernetes in docker), for more details see https://kind.sigs.k8s.io/docs/user/quick-start/#installation -sudo curl -Lo /usr/local/bin/kind "https://kind.sigs.k8s.io/dl/latest/kind-linux-amd64" +sudo curl -Lo /usr/local/bin/kind "https://kind.sigs.k8s.io/dl/v0.20.0/kind-linux-amd64" sudo chmod +x /usr/local/bin/kind -# Install docker-compose, for more details see https://docs.docker.com/compose/install/ -sudo curl -Lo /usr/local/bin/docker-compose "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -sudo chmod +x /usr/local/bin/docker-compose -``` - The following ports are used statically on your host machine: | Port | Bind Address | Description | @@ -92,7 +86,7 @@ make After the deployment and waiting for a short amount of time, two machines in status `PXE booting` become visible through `metalctl machine ls`: ```bash -docker-compose run --rm metalctl machine ls +docker compose run --rm metalctl machine ls ID LAST EVENT WHEN AGE HOSTNAME PROJECT SIZE IMAGE PARTITION e0ab02d2-27cd-5a5e-8efc-080ba80cf258   PXE Booting 3s @@ -102,7 +96,7 @@ e0ab02d2-27cd-5a5e-8efc-080ba80cf258   PXE Booting 3s Wait until the machines reach the waiting state: ```bash -docker-compose run --rm metalctl machine ls +docker compose run --rm metalctl machine ls ID LAST EVENT WHEN AGE HOSTNAME PROJECT SIZE IMAGE PARTITION e0ab02d2-27cd-5a5e-8efc-080ba80cf258   Waiting 8s v1-small-x86 mini-lab @@ -119,13 +113,13 @@ make machine __Alternatively__, you may want to issue the `metalctl` commands on your own: ```bash -docker-compose run --rm metalctl network allocate \ +docker compose run --rm metalctl network allocate \ --partition mini-lab \ --project 00000000-0000-0000-0000-000000000000 \ --name user-private-network # lookup the network ID and create a machine -docker-compose run --rm metalctl machine create \ +docker compose run --rm metalctl machine create \ --description test \ --name machine \ --hostname machine \ @@ -136,7 +130,7 @@ docker-compose run --rm metalctl machine create \ --networks # create a firewall that is also connected to the virtual internet-mini-lab network -docker-compose run --rm metalctl machine create \ +docker compose run --rm metalctl machine create \ --description fw \ --name fw \ --hostname fw \ @@ -160,7 +154,7 @@ machine login: Two machines are now installed and have status "Phoned Home" ```bash -docker-compose run --rm metalctl machine ls +docker compose run --rm metalctl machine ls ID LAST EVENT WHEN AGE HOSTNAME PROJECT SIZE IMAGE PARTITION e0ab02d2-27cd-5a5e-8efc-080ba80cf258   Phoned Home 2s 21s machine 00000000-0000-0000-0000-000000000000 v1-small-x86 Ubuntu 20.04 20200331 mini-lab 2294c949-88f6-5390-8154-fa53d93a3313   Phoned Home 8s 18s fw 00000000-0000-0000-0000-000000000000 v1-small-x86 Firewall 2 Ubuntu 20200730 mini-lab @@ -169,7 +163,7 @@ e0ab02d2-27cd-5a5e-8efc-080ba80cf258   Phoned Home 2s 21s machin Login with user name metal and the console password from ```bash -docker-compose run --rm metalctl machine consolepassword e0ab02d2-27cd-5a5e-8efc-080ba80cf258 +docker compose run --rm metalctl machine consolepassword e0ab02d2-27cd-5a5e-8efc-080ba80cf258 ``` If you want to access the firewall with SSH or have internet connectivity from the firewall and machine, you'll need to have a static route configured that points to the leaf switches: @@ -193,7 +187,7 @@ make cleanup Reinstall a machine with ```bash -docker-compose run --rm metalctl machine reinstall \ +docker compose run --rm metalctl machine reinstall \ --image ubuntu-20.04 \ e0ab02d2-27cd-5a5e-8efc-080ba80cf258 ``` @@ -203,7 +197,7 @@ docker-compose run --rm metalctl machine reinstall \ Free a machine with `make free-machine01` or ```bash -docker-compose run --rm metalctl machine rm e0ab02d2-27cd-5a5e-8efc-080ba80cf258 +docker compose run --rm metalctl machine rm e0ab02d2-27cd-5a5e-8efc-080ba80cf258 ``` ## Flavors