Nodepool - Static

The static driver allows you to use existing compute resources, such as real hardware or long-lived virtual machines, with nodepool.

Node Requirements

Any nodes you setup for nodepool (either real or virtual) must meet the following requirements:

Must be reachable by Zuul executors and have SSH access enabled.
Must have a user that Zuul can use for SSH.
Must have an Ansible supported Python installed
Must be reachable by Zuul executors over TCP port 19885 for console log streaming. See Log streaming

When setting up your nodepool.yaml file, you will need the host keys for each node for the host-key value. This can be obtained with the command:

ssh-keyscan -t ed25519 <HOST>

Nodepool Configuration

Below is a sample Nodepool configuration file that sets up static nodes. Place this file in /etc/nodepool/nodepool.yaml:

sudo bash -c "cat > /etc/nodepool/nodepool.yaml <<EOF
zookeeper-servers:
  - host: localhost

labels:
  - name: ubuntu-jammy

providers:
  - name: static-vms
    driver: static
    pools:
      - name: main
        nodes:
          - name: 192.168.1.10
            labels: ubuntu-jammy
            host-key: "ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIGXqY02bdYqg1BcIf2x08zs60rS6XhlBSQ4qE47o5gb"
            username: zuul
          - name: 192.168.1.11
            labels: ubuntu-jammy
            host-key: "ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIGXqY02bdYqg1BcIf2x08zs60rS6XhlBSQ5sE47o5gc"
            username: zuul
EOF"

Make sure that username, host-key, IP addresses and label names are customized for your environment.

Log streaming

The log streaming service enables Zuul to show the live status of long-running shell or command tasks. The server side is setup by the zuul_console: task built-in to Zuul’s Ansible installation. The executor requires the ability to communicate with the job nodes on port 19885 for this to work.

The log streaming service may leave files on the static node in the format /tmp/console-<uuid>-<task_id>-<host>.log if jobs are interrupted. These may be safely removed after a short period of inactivity with a command such as

find /tmp -maxdepth 1 -name 'console-*-*-<host>.log' -mtime +2 -delete