Add static driver doc to Zuul From Scratch

Change-Id: Iac507cc0c37ed810cd03cd24314d1a7cf153bf91
This commit is contained in:
David Shrewsbury 2018-04-04 08:37:48 -04:00
parent b061db0411
commit b82e3c34bf
2 changed files with 54 additions and 0 deletions

View File

@ -0,0 +1,53 @@
:orphan:
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 Python 2 installed for Ansible.
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.yaml file that sets up static nodes::
zookeeper-servers:
- host: localhost
labels:
- name: ubuntu-xenial
providers:
- name: static-vms
driver: static
pools:
- name: main
nodes:
- name: 192.168.1.10
labels: ubuntu-xenial
host-key: "ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIGXqY02bdYqg1BcIf2x08zs60rS6XhlBSQ4qE47o5gb"
username: zuul
- name: 192.168.1.11
labels: ubuntu-xenial
host-key: "ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIGXqY02bdYqg1BcIf2x08zs60rS6XhlBSQ5sE47o5gc"
username: zuul
Make sure that ``username``, ``host-key``, IP addresses and label names are
customized for your environment.

View File

@ -28,6 +28,7 @@ Nodepool can support different backends. Select the configuration for
your installation.
* :doc:`nodepool_openstack`
* :doc:`nodepool_static`
Zuul
~~~~