nova_status¶
Role Documentation¶
Welcome to the “nova_status” role documentation.
Role Variables: main.yml¶
metadata:
description: "Performs a release-specific readiness check before restarting services\
\ with new code. This command expects to have complete configuration and access\
\ to databases and services within a cell. For example, this check may query the\
\ Nova API database and one or more cell databases. It may also make requests\
\ to other services such as the Placement REST API via the Keystone service catalog\n\
The nova-status upgrade check command has three standard return codes:\n0 -> All\
\ upgrade readiness checks passed successfully and there is nothing to do. 1 ->\
\ At least one check encountered an issue and requires further investigation.\n\
\ This is considered a warning but the upgrade may be OK.\n2 -> There was\
\ an upgrade status check failure that needs to be investigated.\n This should\
\ be considered something that stops an upgrade.\n"
groups:
- pre-upgrade
name: Nova Status Upgrade Check
Molecule Scenarios¶
Molecule is being used to test the “nova_status” role. The following section highlights the drivers in service and provides an example playbook showing how the role is leveraged.
Scenario: default¶
Example default configuration¶
driver:
name: podman
log: true
platforms:
- dockerfile: ../../../../.config/molecule/Dockerfile
environment:
http_proxy: '{{ lookup(''env'', ''http_proxy'') }}'
https_proxy: '{{ lookup(''env'', ''https_proxy'') }}'
hostname: centos
image: centos/centos:stream8
name: centos
pkg_extras: python*-setuptools python*-pyyaml
privileged: true
registry:
url: quay.io
ulimits:
- host
volumes:
- /etc/ci/mirror_info.sh:/etc/ci/mirror_info.sh:ro
provisioner:
env:
ANSIBLE_LIBRARY: ${ANSIBLE_LIBRARY:-/usr/share/ansible/plugins/modules}
ANSIBLE_ROLES_PATH: ${ANSIBLE_ROLES_PATH}:${HOME}/zuul-jobs/roles
ANSIBLE_STDOUT_CALLBACK: yaml
inventory:
hosts:
all:
hosts:
centos:
ansible_python_interpreter: /usr/bin/python3
log: true
name: ansible
options:
vvv: true
scenario:
test_sequence:
- destroy
- create
- prepare
- converge
- verify
- destroy
verifier:
name: ansible
Molecule Inventory¶
hosts:
all:
hosts:
centos:
ansible_python_interpreter: /usr/bin/python3
Example default playbook¶
- gather_facts: false
hosts: all
name: Converge
tasks:
- include_role:
name: nova_status
name: working detection
- block:
- include_role:
name: nova_status
name: run validation
vars:
container_client: docker
name: make validation fail
rescue:
- meta: clear_host_errors
name: Clear host errors
- debug:
msg: The validation works! End play
name: Test output
- meta: end_play
name: End play
- fail:
msg: 'The nova_status validation didn''t properly detect bad upgrade
status check!
'
name: Fail playbook if reached