system-config/launch/README
Monty Taylor a05340b2f6 Use OS_REGION_NAME so that OCC ignore it properly
os-client-config will construct a cloud called "envvars" if the
environment has environment variables that start with OS_ and are not
OS_CLOUD and OS_REGION_NAME (those are singled out because they are
selectors) The convenience variable in our example code snippet here is
an OS_ var that is neither of those, so it causes the environment to
produce an invalid cloud config which then confuses the ansible
inventory which is trying to iterate over the all the clouds that
exist.

Change-Id: I65324bc2f3ca71dd4ada2f39f322ccc5f13d6897
2016-09-16 00:49:11 +00:00

71 lines
2.3 KiB
Plaintext

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 ~/launch-env/
. ~/launch-env/bin/activate
pip install ansible==2.1.1.0 shade==1.12.1
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/production/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