Document how to run multinode integration tests

README.md

@@ -149,6 +149,25 @@ documentation and rspec tests. We are happy to provide guidance if necessary.
 
 Please see [CONTRIBUTING](.github/CONTRIBUTING.md) for more details.
 
+### Multihost integration tests
+
+This repo includes some integration tests that require more than one host.
+These tests will not run with Github Actions at the moment.
+You can run this locally with:
+```sh
+BEAKER_set=debian11-64-multinode bundle exec rake beaker
+```
+You can replace the string `debian11` with the following strings:
+
+* centos7
+* centos8
+* centos9
+* debian10
+* debian11
+* debian12
+* ubuntu2004
+* ubuntu2204
+
 ### Authors
 
 * Puppetlabs Module Team

spec/acceptance/nodesets/centos7-64-multinode.yml

@@ -0,0 +1,29 @@
+---
+HOSTS:
+  node-1:
+    docker_cmd:
+    - "/sbin/init"
+    docker_image_commands:
+    - cp /bin/true /sbin/agetty
+    - yum install -y crontabs initscripts iproute openssl wget which sysvinit-tools
+      tar ss
+    image: quay.io/centos/centos:centos7
+    platform: el-7-x86_64
+    hypervisor: docker
+    roles:
+    - master
+    - shard
+  node-2:
+    docker_cmd:
+    - "/sbin/init"
+    docker_image_commands:
+    - cp /bin/true /sbin/agetty
+    - yum install -y crontabs initscripts iproute openssl wget which sysvinit-tools
+      tar ss
+    image: quay.io/centos/centos:centos7
+    platform: el-7-x86_64
+    hypervisor: docker
+    roles:
+    - slave
+    - router
+CONFIG: {}

spec/acceptance/nodesets/centos9-64-multinode.yml

@@ -0,0 +1,29 @@
+---
+HOSTS:
+  node-1:
+    docker_cmd:
+    - "/sbin/init"
+    docker_image_commands:
+    - cp /bin/true /sbin/agetty
+    - dnf install -y cronie crontabs initscripts iproute openssl wget which glibc-langpack-en
+      hostname
+    image: quay.io/centos/centos:stream9
+    platform: el-9-x86_64
+    hypervisor: docker
+    roles:
+    - master
+    - shard
+  node-2:
+    docker_cmd:
+    - "/sbin/init"
+    docker_image_commands:
+    - cp /bin/true /sbin/agetty
+    - dnf install -y cronie crontabs initscripts iproute openssl wget which glibc-langpack-en
+      hostname
+    image: quay.io/centos/centos:stream9
+    platform: el-9-x86_64
+    hypervisor: docker
+    roles:
+    - slave
+    - router
+CONFIG: {}

spec/acceptance/nodesets/debian10-64-multinode.yml

@@ -0,0 +1,29 @@
+---
+HOSTS:
+  node-1:
+    docker_cmd:
+    - "/sbin/init"
+    docker_image_commands:
+    - cp /bin/true /sbin/agetty
+    - rm -f /usr/sbin/policy-rc.d
+    - apt-get update && apt-get install -y cron locales-all net-tools wget gnupg iproute2
+    image: amd64/debian:10
+    platform: debian-10-amd64
+    hypervisor: docker
+    roles:
+    - master
+    - shard
+  node-2:
+    docker_cmd:
+    - "/sbin/init"
+    docker_image_commands:
+    - cp /bin/true /sbin/agetty
+    - rm -f /usr/sbin/policy-rc.d
+    - apt-get update && apt-get install -y cron locales-all net-tools wget gnupg iproute2
+    image: amd64/debian:10
+    platform: debian-10-amd64
+    hypervisor: docker
+    roles:
+    - slave
+    - router
+CONFIG: {}

spec/acceptance/nodesets/debian11-64-multinode.yml

@@ -0,0 +1,29 @@
+---
+HOSTS:
+  node-1:
+    docker_cmd:
+    - "/sbin/init"
+    docker_image_commands:
+    - cp /bin/true /sbin/agetty
+    - rm -f /usr/sbin/policy-rc.d
+    - apt-get update && apt-get install -y cron locales-all net-tools wget gnupg iproute2
+    image: amd64/debian:11
+    platform: debian-11-amd64
+    hypervisor: docker
+    roles:
+    - master
+    - shard
+  node-2:
+    docker_cmd:
+    - "/sbin/init"
+    docker_image_commands:
+    - cp /bin/true /sbin/agetty
+    - rm -f /usr/sbin/policy-rc.d
+    - apt-get update && apt-get install -y cron locales-all net-tools wget gnupg iproute2
+    image: amd64/debian:11
+    platform: debian-11-amd64
+    hypervisor: docker
+    roles:
+    - slave
+    - router
+CONFIG: {}

spec/acceptance/nodesets/debian12-64-multinode.yml

@@ -0,0 +1,29 @@
+---
+HOSTS:
+  node-1:
+    docker_cmd:
+    - "/sbin/init"
+    docker_image_commands:
+    - cp /bin/true /sbin/agetty
+    - rm -f /usr/sbin/policy-rc.d
+    - apt-get update && apt-get install -y cron locales-all net-tools wget gnupg iproute2
+    image: amd64/debian:12
+    platform: debian-12-amd64
+    hypervisor: docker
+    roles:
+    - master
+    - shard
+  node-2:
+    docker_cmd:
+    - "/sbin/init"
+    docker_image_commands:
+    - cp /bin/true /sbin/agetty
+    - rm -f /usr/sbin/policy-rc.d
+    - apt-get update && apt-get install -y cron locales-all net-tools wget gnupg iproute2
+    image: amd64/debian:12
+    platform: debian-12-amd64
+    hypervisor: docker
+    roles:
+    - slave
+    - router
+CONFIG: {}

spec/acceptance/nodesets/ubuntu2004-64-multinode.yml

@@ -0,0 +1,31 @@
+---
+HOSTS:
+  node-1:
+    docker_cmd:
+    - "/sbin/init"
+    docker_image_commands:
+    - cp /bin/true /sbin/agetty
+    - apt-get install -y net-tools wget locales iproute2 gnupg
+    - locale-gen en_US.UTF-8
+    - echo LANG=en_US.UTF-8 > /etc/default/locale
+    image: amd64/ubuntu:20.04
+    platform: ubuntu-20.04-amd64
+    hypervisor: docker
+    roles:
+    - master
+    - shard
+  node-2:
+    docker_cmd:
+    - "/sbin/init"
+    docker_image_commands:
+    - cp /bin/true /sbin/agetty
+    - apt-get install -y net-tools wget locales iproute2 gnupg
+    - locale-gen en_US.UTF-8
+    - echo LANG=en_US.UTF-8 > /etc/default/locale
+    image: amd64/ubuntu:20.04
+    platform: ubuntu-20.04-amd64
+    hypervisor: docker
+    roles:
+    - slave
+    - router
+CONFIG: {}

spec/acceptance/nodesets/ubuntu2204-64-multinode.yml

@@ -0,0 +1,31 @@
+---
+HOSTS:
+  node-1:
+    docker_cmd:
+    - "/sbin/init"
+    docker_image_commands:
+    - cp /bin/true /sbin/agetty
+    - apt-get install -y net-tools wget locales iproute2 gnupg
+    - locale-gen en_US.UTF-8
+    - echo LANG=en_US.UTF-8 > /etc/default/locale
+    image: amd64/ubuntu:22.04
+    platform: ubuntu-22.04-amd64
+    hypervisor: docker
+    roles:
+    - master
+    - shard
+  node-2:
+    docker_cmd:
+    - "/sbin/init"
+    docker_image_commands:
+    - cp /bin/true /sbin/agetty
+    - apt-get install -y net-tools wget locales iproute2 gnupg
+    - locale-gen en_US.UTF-8
+    - echo LANG=en_US.UTF-8 > /etc/default/locale
+    image: amd64/ubuntu:22.04
+    platform: ubuntu-22.04-amd64
+    hypervisor: docker
+    roles:
+    - slave
+    - router
+CONFIG: {}