Skip to content

Commit

Permalink
Update docs for --mod-cloud.
Browse files Browse the repository at this point in the history
* Make section for --mod-cloud docs and references to use this instead
  of making changes to MongoDB for most things.
* Other small doc updates.

Change-Id: I0b81abc6d3d0d09af3ad4353f5d362f80d511f99
  • Loading branch information
sadsfae committed Dec 1, 2020
1 parent 5efc99a commit 2674bc3
Showing 1 changed file with 25 additions and 0 deletions.
25 changes: 25 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -52,6 +52,7 @@ QUADS automates the future scheduling, end-to-end provisioning and delivery of b
* [Removing a Host from QUADS](#removing-a-host-from-quads)
* [Using the QUADS JSON API](#using-the-quads-json-api)
* [Additional Tools and Commands](#additional-tools-and-commands)
* [Modifying Cloud-level Attributes](#modifying-cloud-level-attributes)
* [Looking into the Future](#looking-into-the-future)
* [Dry Run for Pending Actions](#dry-run-for-pending-actions)
* [Find Free Cloud Environment](#find-free-cloud-environment)
Expand Down Expand Up @@ -585,6 +586,8 @@ if you need to clear the vlan association with your cloud, rerun your command an
quads-cli --define-cloud cloud03 --description "Messaging AMQ" --force --cloud-owner epresley --cc-users "jdoe jhoffa" --cloud-ticket 423625 --qinq 1
```

* Note: in QUADS `1.1.4` you can change any of these values selectively via the `--mod-cloud` command [described below](#modifying-cloud-level-attributes).

- Now that you've defined your new cloud you'll want to allocate machines and a schedule.
- We're going to find the first 20 Dell r620's and assign them as an example.

Expand Down Expand Up @@ -846,6 +849,26 @@ Removed: {'host': 'f03-h30-000-r720xd.rdu2.example.com'}

## Additional Tools and Commands

### Modifying Cloud-level Attributes
* You can re-define or change any aspects of an already-defined cloud starting in `1.1.4` with the `--mod-cloud` command.
* This can be done a per-parameter or combined basis:

```
quads-cli --mod-cloud cloud02 --cloud-owner jhoffa
```

```
quads-cli --mod-cloud cloud04 --cc-users "tpetty fmercury"
```

```
quads-cli --mod-cloud cloud06 --vlan 604 --wipe
```

```
quads-cli --mod-cloud cloud50 --no-wipe
```

### Looking into the Future
* Because QUADS knows about all future schedules you can display what your environment will look like at any point in time using the `--date` command.

Expand Down Expand Up @@ -948,6 +971,8 @@ quads-cli --ls-hosts --filter "interfaces.mac_address==ac:1f:6b:2d:19:48"
## Interacting with MongoDB
* In some scenarios you may wish to interrogate or modify values within MongoDB. You should be careful doing this and have good backups in place. Generally, we will try to implement data, object and document modification needs through quads-cli so you don't need to do this but sometimes it's useful for troubleshooting or other reasons.

* **NOTE**: For most of the below examples usage of `quads-cli --mod-cloud` supplants the need for making any changes in MongoDB post QUADS version `1.1.4`. We'll leave these examples below for posterity or in the case they can be modeled to do something else useful otherwise.

* Example: Toggling the `wipe:` cloud value that determines whether new systems entering an environment should be reprovisioned or not. In this example `cloud02` has the value of `wipe: 0` and we want to change this within Mongodb.

- First run `mongo` to enter cli mode
Expand Down

0 comments on commit 2674bc3

Please sign in to comment.