quickstart is missing how to just run the teardown actions

[Alex Schultz]

The documentation on how to run just the teardown actions in quickstart is a bit lacking. It used to be able to be run by ./quickstart.sh --teardown all --skip-tags all $HOST. This no longer works. It appears that ./quickstart.sh --tags teardown-all $HOST works. But we should settle on a command and document it.

[Quique Llorente (quiquell)]

Executing ./quickstart.sh --teardown all --skip-tags all 127.0.0.2 runs the proper playbooks for the teardown

[deployer@rdo-ci-fx2-01-s4 tripleo-quickstart]$ grep Tear _quickstart.log
PLAY [Tear down non-root user on virt host] ********************************************************************
PLAY [Tear down undercloud and overcloud vms] ******************************************************************
PLAY [Tear down environment] ********************************************************************************

What's the issue ?

[Alex Schultz (alex-schultz)]

They are all skipped. Please check the actual log.

./quickstart.sh --teardown all --skip-tags all 192.168.0.7

PLAY [Run setup again on virthost] **********************************************************************************************************************************************************************************
skipping: no hosts matched

PLAY [Tear down undercloud and overcloud vms] ***********************************************************************************************************************************************************************
skipping: no hosts matched

PLAY [Tear down environment] ****************************************************************************************************************************************************************************************
skipping: no hosts matched

[Quique Llorente (quiquell)]

The --skip-tags all is skipping adding virthost to the in memory inventory, let me check.

[Quique Llorente (quiquell)]

So this are the three scenarios and I think none of it works correctly:

- ./quickstart --teardown all --skip-tags all $VIRTHOST
  --skip-tags all have precedence over the specified tags, so non is executed

- ./quickstart --tags teardown-all $VIRTHOST
  Only executes teardown-node,teardown-all, without provision tag this doesn't work (virthost is not added to the inventory)

- ./quickstart --teardown all $VIRTHOST
  Executes too many tags untagged,provision,environment,libvirt,undercloud-scripts,undercloud-inventory,overcloud-scripts,undercloud-setup,undercloud-install,undercloud-post-install,tripleoui-validate,teardown-all

I will try to mark the needed tasks with teardown tags, so just --teardown <foo> should work.

[Quique Llorente (quiquell)]

To be able to do only the cleanup with -t teardown-all this patch tags with teardown-x the inventory PLAY.

https://review.openstack.org/564712

[Rafael Folco (rafaelfolco)]

I agree -T should be enough. Just for the record...

Today, if you want to teardown you should use teardown playbook AND use keep inventory flag:

bash quickstart.sh -I -R master --no-clone --tags all -p teardown.yml $VIRTHOST

https://bugs.launchpad.net/tripleo/+bug/1742142

[Quique Llorente (quiquell)]

So let's merge the gerrit and change the doc to include how to do just a total teardown

[Alex Schultz (alex-schultz)]

For the record, "bash quickstart.sh -I -R master --no-clone --tags all -p teardown.yml $HOST" is not terribly intuitive for a new user to understand how to run. "quickstart.sh --tags teardown-all $HOST" is much simpler and easier to understand.

[OpenStack Infra (hudson-openstack)]

Reviewed: https://review.openstack.org/564712
Committed: https://git.openstack.org/cgit/openstack/tripleo-quickstart/commit/?id=69e473985a720d06ca924ceef09dd065bfa3f086
Submitter: Zuul
Branch: master

commit 69e473985a720d06ca924ceef09dd065bfa3f086
Author: Enrique Llorente <email address hidden>
Date: Fri Apr 27 11:26:34 2018 +0200

    Tag "Add the virthost to the inventory" as teardown-

    To run only the teardown-all with -t teardown-all doesn't work,
    virthost is missing in the ansible memory inventory.

    Closes-Bug: 1766326

    Change-Id: Ia0c70b49bfcabea49b673d605c1bf1775ce007e5

[Quique Llorente (quiquell)]

Now executing just ./quickstart -t teardown-all $VIRTHOST should work.

[OpenStack Infra (hudson-openstack)]

This issue was fixed in the openstack/tripleo-quickstart 2.1.1 release.