This includes newer cookstyle rules that we should be checking for. Change-Id: I6f1bedfe30dd3455570b41862e01b0c928f5e565 Signed-off-by: Lance Albertson <firstname.lastname@example.org>
|4 months ago|
|.chef||4 years ago|
|.delivery||11 months ago|
|data_bags||8 months ago|
|deploy-guide/source||8 months ago|
|doc||5 months ago|
|environments||8 months ago|
|playbooks||4 months ago|
|roles||11 months ago|
|scripts||8 months ago|
|test||4 months ago|
|tools||11 months ago|
|.gitignore||1 year ago|
|.gitreview||1 year ago|
|.kitchen.dokken.yml||1 year ago|
|.kitchen.multi.yml||1 year ago|
|.zuul.yaml||5 months ago|
|Berksfile||8 months ago|
|CONTRIBUTING.rst||1 year ago|
|LICENSE||8 years ago|
|README.rst||4 months ago|
|Rakefile||8 months ago|
|TESTING.rst||1 year ago|
|bindep.txt||3 years ago|
|kitchen.yml||6 months ago|
|setup.cfg||10 months ago|
|setup.py||10 months ago|
|tox.ini||1 year ago|
This is the testing framework for OpenStack deployed using Chef. We leverage this to test against our changes to our cookbooks to make sure that you can still build a cluster from the ground up with any changes we introduce.
This framework also gives us an opportunity to show different Reference Architectures and a sane example on how to start with OpenStack using Chef.
master branch of the cookbooks, which is currently tied to the base OpenStack Train release, this supports deploying to Ubuntu 18.04 and CentOS 7 in monolithic, or allinone, and non-HA multinode configurations with Neutron. The cookbooks support a fully HA configuration, but we do not test for that as there are far numerous paths to HA.
$ git clone https://opendev.org/openstack/openstack-chef.git $ cd openstack-chef
The OpenStack cookbooks by default use encrypted data bags for configuring passwords. There are four data bags :
secrets. There already exists a
data_bags/ directory, so you shouldn't need to create any for a proof of concept. If you do, something is wrong. See the Data Bags section for the gory details.
For each deployment model, there is a corresponding file in the
doc/ directory. Please review that for specific details and additional setup that might be required before deploying the cloud.
These commands will produce various OpenStack cluster configurations, the simplest being a monolithic Compute Controller with Neutron (allinone) which contains all supported cookbooks being deployed.
Due to memory constraints with our CI environment, we also have the minimal suite which only tests keystone, glance, neutron, cinder and nova. Running this suite should duplicate what we do in our CI pipeline. We also have individual suites for each cookbook if you are just working on a single cookbook and don't require the allinone suite.
These deployments are not intended to be production-ready, and will need adaptation to your environment. This is intended for development and proof of concept deployments.
$ eval "$(chef shell-init bash)"
# allinone with all supported cookbooks $ kitchen test "default-(centos|ubuntu)"
$ kitchen login [centos|ubuntu] $ sudo su -
# Multinode with Neutron (1 controller + 2 compute nodes) $ export KITCHEN_YAML=.kitchen.multi.yml $ kitchen converge [centos|ubuntu|all] $ kitchen verify [centos|ubuntu|all] $ kitchen destroy [centos|ubuntu|all]``
$ kitchen login controller-[centos|ubuntu] $ sudo su -
$ cd vms $ kitchen login compute1 # OR $ kitchen login compute2 $ sudo su -
# Access the controller as noted above $ source /root/openrc $ nova --version $ openstack service list && openstack hypervisor list $ openstack image list $ openstack user list $ openstack server list
To allow SSH access to instances, a security group is defined as follows:
$ openstack security group list $ openstack security group list default $ openstack security group create allow_ssh --description "allow ssh to instances" $ openstack security group rule create allow_ssh --protocol tcp --dst-port 22:22 --remote-ip 0.0.0.0/0 $ openstack security group list allow_ssh
To allow SSH keys to be injected into instance, a key pair is defined as follows:
# generate a new key pair $ openstack keypair create mykey > mykey.pem $ chmod 600 mykey.pem $ openstack keypair create --public-key ~/.ssh/id_rsa.pub mykey # verify the key pair has been imported $ openstack keypair list
$ openstack server create --flavor 1 --image cirros --security-group allow_ssh --key-name mykey test
Wait a few seconds and the run
openstack server list if Status is not Active, wait a few seconds and repeat.
Once status is active you should be able to log in using SSH, or
vagrant ssh <vm_name>
$ ssh cirros@<ip address from openstack server list output>
If you would like to use the OpenStack dashboard you should go to https://localhost:9443 and the username and password is
If you log in to the
controller machine you can test via the most recent Tempest release.
$ cd vms $ vagrant ssh <controller> $ sudo su - root@controller:~ cd /opt/tempest root@controller:/opt/tempest$ ./run_tempest.sh -V --smoke --serial [-- snip --] tempest.tests.test_wrappers.TestWrappers test_pretty_tox 1.68 test_pretty_tox_fails 1.03 test_pretty_tox_serial 0.61 test_pretty_tox_serial_fails 0.55 Ran 233 tests in 13.869s OK Running flake8 ... $
To remove all the nodes and start over again with a different environment or different environment attribute overrides, using the following rake command.
$ chef exec rake destroy_machines
To refresh all cookbooks, use the following commands.
$ rm -rf cookbooks $ chef exec rake berks_vendor
To clean up everything, use the following rake command.
$ chef exec rake clean
Some basic information about the use of data bags within this repo.
# Show the list of data bags $ chef exec knife data bag list -z db_passwords secrets service_passwords user_passwords # Show the list of data bag items $ chef exec knife data bag show db_passwords -z cinder dash glance horizon keystone neutron nova # Show contents of data bag item $ chef exec knife data bag show db_passwords nova -z Encrypted data bag detected, decrypting with provided secret. nova: mypass id: nova # Update contents of data bag item # set EDITOR env var to your editor. eg. EDITOR=vi $ chef exec knife data bag edit secrets dispersion_auth_user -z
db_passwords are set to "mypass" secrets are set to
token_service passwords are set to "mypass"
user_passwords are set to "mypass"
The default secret is stored here
.chef/encrypted_data_bag_secret and referenced by
When we say defaults, we mean that they are known by everyone with access to this repository. Change these to something else before deploying for real.
When using this on a Windows platform, here are some tweaks to make this work:
C:\Program Files (x86)\Git\bin;to the system PATH.
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.