Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Bump releases to version v0.15.14-rc.0 #175

Closed
wants to merge 2 commits into from
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion Makefile
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
.DEFAULT_GOAL := build
RELEASE_VERSION := $(or ${RELEASE_VERSION},"v0.15.11")
RELEASE_VERSION := $(or ${RELEASE_VERSION},"v0.15.14-rc.0")

ifeq ($(CI),true)
DOCKER_TTY_ARG=
Expand Down
3 changes: 2 additions & 1 deletion docs/src/external/metalctl/docs/metalctl_update.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,8 @@ update the program
## Options

```
-h, --help help for update
-h, --help help for update
-v, --version string the version to update to
```

## Options inherited from parent commands
Expand Down
34 changes: 14 additions & 20 deletions docs/src/external/mini-lab/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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)

Expand All @@ -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 |
Expand Down Expand Up @@ -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
Expand All @@ -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
Expand All @@ -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 \
Expand All @@ -136,7 +130,7 @@ docker-compose run --rm metalctl machine create \
--networks <network-ID>

# 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 \
Expand All @@ -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
Expand All @@ -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:
Expand All @@ -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
```
Expand All @@ -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
Expand Down