system-config/launch
Monty Taylor 1a8c2f66da
Move /opt/system-config/production to /opt/system-config
The production directory is a relic from the puppet environment concept,
which we do not use. Remove it.

The puppet apply tests run puppet locally, where the production
environment is still needed, so don't update the paths in the
tools/prep-apply.sh.

Depends-On: https://review.openstack.org/592946
Change-Id: I82572cc616e3c994eab38b0de8c3c72cb5ec5413
2018-08-17 09:41:02 -05:00
..
dns.py Add base playbooks and roles to bootstrap a new server 2018-08-01 14:57:44 -07:00
launch-node-ansible.py Add base playbooks and roles to bootstrap a new server 2018-08-01 14:57:44 -07:00
launch-node.py Add base playbooks and roles to bootstrap a new server 2018-08-01 14:57:44 -07:00
README Move /opt/system-config/production to /opt/system-config 2018-08-17 09:41:02 -05:00
sshclient.py launch-node.py: More verbose logging 2016-08-24 11:06:57 +10:00
utils.py Add base playbooks and roles to bootstrap a new server 2018-08-01 14:57:44 -07:00

Create Server
=============

Note that these instructions assume you're working from this
directory on an updated local clone of the repository on the
puppetmaster, and that your account is a member of the admin
and puppet groups for access to their respective keys::

  sudo adduser $(whoami) admin
  sudo adduser $(whoami) puppet

(Remember to log out and back into your shell if you add yourself
to a group.)

Launching a node currently requires a different version of ansible
than what is generally used on the puppetmaster.  Set up a
virtualenv::

  virtualenv -p python2 ~/launch-env/
  . ~/launch-env/bin/activate
  pip install ansible==2.1.1.0 shade

To launch a node in the OpenStack CI account (production servers)::

  . ~/launch-env/bin/activate
  export OS_CLOUD=openstackci-rax
  export OS_REGION_NAME=DFW
  export FLAVOR="8 GB Performance"
  export FQDN=servername01.openstack.org
  cd /opt/system-config/launch/
  ./launch-node.py $FQDN --flavor "$FLAVOR" \
    --cloud=$OS_CLOUD --region=$OS_REGION_NAME

To launch a node in the OpenStack Jenkins account (slave nodes)::

  . ~/launch-env/bin/activate
  export OS_CLOUD=openstackjenkins-rax
  export OS_REGION_NAME=DFW
  export FQDN=slavename01.slave.openstack.org
  openstack image list
  export IMAGE='Ubuntu 12.04 LTS (Precise Pangolin) (PVHVM)'
  openstack flavor list
  export FLAVOR="8 GB Performance"
  ./launch-node.py $FQDN --image "$IMAGE" --flavor "$FLAVOR" \
     --cloud=$OS_CLOUD --region=$OS_REGION_NAME

Manually add the hostname to DNS (the launch script does not do so
automatically). Note that this example assumes you've already
exported a relevant FQDN and sourced the appropriate API credentials
above.

In order for Ansible to be able to send out the Puppet updates,
you also need the puppetmaster to accept the root SSH key for the
new server. So as root on the puppetmaster:

  ssh root@$FQDN

Verify the fingerprint of the new server and type "yes" to accept.
Then you can log out.

Add DNS Records
===============

There are no scripts to automatically handle DNS at the moment due to
a lack of library support for the new Rackspace Cloud DNS (with IPv6).
However, the launch-node script will print the commands needed to be
run to configure DNS for a newly launched server.  To see the commands
for an existing server, run:

  ./dns.py $FQDN