63 Commits

Author SHA1 Message Date
Ian Wienand
814e4be128 Ansible roles for backup
This introduces two new roles for managing the backup-server and hosts
that we wish to back up.

Firstly the "backup" role runs on hosts we wish to backup.  This
generates and configures a separate ssh key for running bup and
installs the appropriate cron job to run the backup daily.

The "backup-server" job runs on the backup server (or, indeed
servers).  It creates users for each backup host, accepts the remote
keys mentioned above and initalises bup.  It is then ready to receive
backups from the remote hosts.

This eliminates a fairly long-standing requirement for manual setup of
the backup server users and keys; this section is removed from the
documentation.

testinfra coverage is added.

Change-Id: I9bf74df351e056791ed817180436617048224d2c
2019-08-05 16:59:57 +10:00
Jeremy Stanley
4c04ad5436 Correct emergency file reference in launch script
The launch script is referring to the wrong path for the emergency
inventory. Also correct the references in the sysadmin guide and
update the example for using it.

Change-Id: I80bdbd440ec451bcd6fb1a3eb552ffda32407c44
2019-07-26 14:55:32 +00:00
Jeremy Stanley
861f5e893f Streamline documented bup setup process
Reorder some of the commands used to set up and configure the bup
user on backup servers so the process is more straightforward and
requires fewer mental context switches.

Change-Id: I73cb80a04b8b5a74bb0857b4c8b6fb09030d6306
2019-06-18 23:57:19 +00:00
Monty Taylor
d500651367 Rename cgit_file to git_file
In sphinx, we have a :cgit_file: directive that makes links to files.
Thing is - we're not using cgit anymore. So just rename it to git_file.

Change-Id: I80aca5fb3cc84281e29843944fea33e6f4d9fe6f
2019-04-22 11:47:11 +00:00
Monty Taylor
eaa74543de Finish updating docs for opendev
The zuul and zuulv3 docs need to be merged, but that seemed like
too much for this. Also, the 3rd party CI doc is out of date, but
in this patch only removed sections that linked to docs or files
that don't exist anymore.

Change-Id: Ie5497edd762d2146165608f3227b0bac88a913df
2019-04-20 18:25:37 +00:00
Ian Wienand
d4a6f1269a Backup rotation procedure
Add a backup rotation procedure to the sysadmin documentation

Change-Id: I366198c635c7fd7f8e1876296bf9357dd577bf56
2019-03-19 12:12:16 +11:00
Ian Wienand
1c48bfe327 Enable github shared admin account
This change describes the shared github administrator account.

This is inspired by I0c61f192a6b5164af7babde5c99e5ee2b77a652c.  As
described there, this allows for admins to have private accounts in
the organisation, but requires that 2FA be turned on.  If people wish
to keep this as a single account which they do "real" work with
(commits, etc) that is probably OK, but add a note that you'll end up
with a lot of mostly irrelevant stuff in your feeds.

Change-Id: Ic408250571133796b4b4639715fe8d01f91898f2
2018-12-12 10:48:16 +11:00
Ian Wienand
8a95c976e9 Add a workflow overview for adding a cloud
Add some details about how we integrate a new cloud into the
ecosystem.  I feel like this is an appropriate level of detail given
we're dealing with clueful admins who just need a rough guide on what
to do and can fill in the gaps.

Fix up the formatting a bit while we're here.

Change-Id: Iba3440e67ab798d5018b9dffb835601bb5c0c6c7
2018-10-19 16:38:00 +00:00
Andreas Jaeger
1c6b4876eb Cleanup docs formatting
Fix indents of some pages, the wrong indent let to gray bars besides
them.

Also, fix a typo and add some markup.

Change-Id: I6e7126ef7b782b376efcc7c6d69c6de9a504ddb5
2018-08-24 22:13:37 +02:00
Monty Taylor
c716240692
Clean up puppetmaster puppet config handled by ansible
We have a bunch of this handled now in ansible, so remove the old stuff.

Remove puppetmaster group management files. It's confusing for there to
be two files. Remove the old one.

Remove mqtt config. This isn't really a thing currently, and we're
eyeing running things from zuul anyway, so no need to port to ansible.

Change-Id: I8b64d21eadcc4a08bd5e5440fc5f756ae5bcd46b
2018-08-17 11:53:52 -05:00
Monty Taylor
bab6fcad3c
Remove base.yaml things from openstack_project::server
Now that we've got base server stuff rewritten in ansible, remove the
old puppet versions.

Depends-On: https://review.openstack.org/588326
Change-Id: I5c82fe6fd25b9ddaa77747db377ffa7e8bf23c7b
2018-08-16 17:25:10 -05:00
Zuul
04aac06820 Merge "Update Gerrit project renaming for Zuul v3" 2018-08-01 16:45:10 +00:00
Ian Wienand
882b730fdf Update to openstackdocstheme
This modernises the openstack-infra documentation by switching to
openstackdocstheme.  Update dependencies as required.

To remove non-relevant stuff from conf.py, I have just taken the demo
file from openstackdocstheme and lightly modified it.

It seems later sphinx has included it's own ":file:" role which now
conflicts.  Change it it ":cgit_file:" in our documentation.  Remove
the custom header template which no longer applies.  Add the
post-2.0-pbr sphinx-based warning-as-error, which fixes the original
problem that I actually noticed that errors could slip through the
gate tests :)

Change-Id: Ic7bec57b971bb4c75fc839e7269d1f69a576b85c
2018-06-25 11:19:43 +10:00
Jeremy Stanley
cbbceb2330 Update Gerrit project renaming for Zuul v3
With the switch to Zuul v3, we need to resolve some configuration
catch-22s where project names and related in-repository job
definitions can't happen without a complex multi-stage removal and
reintroduction process to get it through speculative testing
successfully. For now, just punt and use monolithic changes
bypassing CI in code review. As an up side, the Ansible automation
of this process coupled with Zuul v3's increased resilience to
on-the-fly configuration changes means we can skip stopping/starting
it now and significantly simplify the process.

Since we're here, correct the section heading level for
"Force-Merging a Change" in the sysadmin document.

Change-Id: I335c23abd0b5706f43bbea2dd8cfffa4280dd5db
2018-03-19 15:26:58 +00:00
Ian Wienand
5b2ac45099 Add a note on the shared infra root mail account
Change-Id: Id8ae73f99f46d5f0224c8d9145d5c06ee9ea09da
2018-02-08 12:01:55 +11:00
Zuul
81a86fa41a Merge "Add docs to replace a cinder volume" 2017-11-20 21:13:22 +00:00
Ian Wienand
60b89d662e Remove ci-backup-rs-ord.openstack.org
Migrate backups to new backup01.ord.rax.ci.openstack.org

We decided to start fresh backups on the new server, so this is ready
to go.  I have performed an initial backup on each server so it has
accepted the host key of the new server and been tested (I also fixed
up review-dev.o.o, which was rebuilt but keys not updated ... todo:
add this to puppet, but since it changes so infrequently not high
priority).

Change-Id: I0872f9fcf4a334d32f632b3cb04801deefab4fd1
2017-11-15 09:28:55 +11:00
James E. Blair
b8722bc67c Add documentation on force-merging a change
Change-Id: Ie6fd2a7fa968909440ae3a30b64a6b80792dd1c5
2017-10-12 01:50:05 +00:00
Paul Belanger
d485cc7e11 Add docs to replace a cinder volume
We usually want to do these steps to avoid volume outages when
rackspace is doing updates.

Change-Id: Ie5de97484dddb9136c240baf46724646e39df67e
Signed-off-by: Paul Belanger <pabelanger@redhat.com>
2017-03-23 13:22:47 -04:00
Clark Boylan
b61a3eb7a4 Clean up backups documentation
This adds the now required bup init command to the server to be backed
up. Also remove now gone HPCloud backup server and fix quotes around
command for catting public ssh key.

Change-Id: I607a7c079b16d7f1e94d6b0888cd6e302a04f68f
2017-02-08 10:38:27 -08:00
Jenkins
1960078a1d Merge "Use an ordinal server naming pattern" 2016-06-30 20:14:40 +00:00
Jenkins
abf31b52e9 Merge "Update cinder mgmt docs to use openstackclient" 2016-06-19 00:54:31 +00:00
Jenkins
4d04652b3f Merge "Add more lvm commands to cinder documentation" 2016-05-26 02:32:39 +00:00
Jeremy Stanley
3ac0a5eb69 Use an ordinal server naming pattern
As discussed during the "Launch Node, Ansible and Puppet" summit
session in Austin, we're making things unnecessarily hard on
ourselves by insisting on having multiple servers in our inventory
with the same name. In order to make server addition and replacement
automation simpler, start using an ordinal suffix on server short
names to differentiate them (we can still easily rely on DNS for
their non-numbered convenience names).

Change-Id: I040a5c3b5e1abc50c3e4676bcab0bf4eaa550f4b
2016-05-23 19:42:18 +00:00
Leif Madsen
bdd7085987
Minor documentation tweaks
Change-Id: Iece51871918979875f10eeaac0795c23232832d3
2016-04-27 22:29:05 -04:00
Spencer Krum
f76f5f446f Update cinder mgmt docs to use openstackclient
Instead of using a special cinder.sh and cinder vhost, use openstack
client with clouds.yaml.

Change-Id: I6a14a5fda09929d8345036ca4c54f387acd4fdc0
2016-04-14 13:26:23 -07:00
Spencer Krum
55e28bbe0b Add more lvm commands to cinder documentation
Sometimes we want to extend a logical volume to the entire size of the
volume group. The command to do this is quite strange and I am tried of
googling it. It is so documented.

Change-Id: I600ceb41c57e27eaaf68a1643be848cd331130a5
2016-04-14 12:54:06 -07:00
Jenkins
7ae85a3dbc Merge "Fix file link to groups.txt in sysadmin docs" 2016-03-11 11:23:38 +00:00
James E. Blair
1b7b8e0569 Add instructions on using openstackclient
Change-Id: I3a4c3618e1d558c80c7c0bcee94bb32027397311
2016-02-24 13:03:19 -08:00
Elizabeth K. Joseph
0f529255a9 Fix file link to groups.txt in sysadmin docs
Change-Id: I888beeebb70b16707661908992edb55f7f38f50c
2016-02-24 11:49:53 -08:00
Monty Taylor
765c1474b7 Use groups.txt for disabling hosts for puppet
We already have a dynamic system for managing static group management.
Use it for the disabled group so that the rules for managing the members
are not different.

Also, update the disabled list to match reality.

Also, Update docs because hosts are no longer groups

The upstream OpenStack Inventory in Ansible was fixed to no longer
return each cloud host as its own group unless there are duplicates for
the host in question. This  means it's no longer the right thing to do
to put hosts into disabled:children - disabled is just fine.

Change-Id: I95c83ed64801db15ad99a14547895f3520356f99
2016-01-20 11:38:20 -05:00
Monty Taylor
4e62f20007 Use puppet apply instead of puppet agent
At long last, the day of reckoning is here. Run puppet apply and then
copy the log files back and post them to puppetdb.

Change-Id: I919fea64df0fbb8681e91ac9425b4c43760bb3dd
2016-01-19 18:40:28 -05:00
James E. Blair
447ce13318 Clarify section on ansible inventory file
Change-Id: I3c5acb7a45c482854f68e9c9f008a2fa6ed945be
2015-12-04 11:07:51 -08:00
Monty Taylor
69ef1c7036 Add examples to make the disabling prose clearer
The way disabling works with puppet and openstack inventory in ansible
can be confusing at first. Some examples hopefully clarify the
situation.

Change-Id: Ib85feebce309896c6f3d139318dd5d204d9cb8ec
2015-12-04 14:02:34 -05:00
Monty Taylor
b23025acaa Fix three nits
These were caught in earlier reviews.

Change-Id: I026678fbbe871ffb138fd2c0dba9e788457da3a0
2015-11-30 22:24:53 -06:00
Monty Taylor
714c934d0c Use OpenStack for inventory instead of puppet
With the puppetmaster not there anymore, we should consume inventory
from OpenStack rather than from puppet.

It turns out that because of the way static and dynamic inventories get
merged, the static file needs to stand alone. SO - if you need to
disable a dynamic host from OpenStack (pretty much all of our hosts) you
need to not only add it to dynamic:children, you need to add an emtpy
group into the static file too, otherwise you'll get an error like:

 root@puppetmaster:~# ansible -i newinv '!disabled' --list-hosts
 ERROR: newinv/static:4: child group is not defined: (jenkins-dev.openstack.org)

Change-Id: Ic6809ed0b7014d7aebd414bf3a342e3a37eb10b6
2015-11-30 22:02:41 -06:00
Jenkins
0fbbcb0ea9 Merge "Add shade and openstack inventory to system" 2015-11-30 22:51:25 +00:00
Monty Taylor
7cee605a77 Add shade and openstack inventory to system
We're not ready to move from puppet inventory to openstack inventory
just yet, so don't actually swap the dynamic inventory plugin. But, add
it to the system so that running manual tests of all of the pieces is
possible.

Add the currently administratively disabled hosts to the disabled group
so that we can verify this works.

Change-Id: I73931332b2917b71a008f9213365f7594f69c41e
2015-11-28 15:59:10 -05:00
Spencer Krum
2fcf4ef6e9 We only backup to one server
Make the docs jive with reality.

Change-Id: Ic9a43cdd4bff041bec32be9d7110778bd5d6effc
2015-11-27 12:04:19 -08:00
AzherKhan
0bcb21f90f Update the sample puppet code block for etherpad
Updating the sample puppet code block for etherpad
on System Administration Wiki as it was referring
to an old etherpad puppet code.

Change-Id: Ibd2d2ee1febf909d5851b829a4a9c5f2d620a20f
2015-10-27 23:28:27 +05:30
Jeremy Stanley
0aa4acd536 Correct internal doc anchor for cinder vol mgmt
Change-Id: I6af62e8bb524feda96548f9fb2aeded7b35fdced
2015-04-20 21:45:05 +00:00
Elizabeth K. Joseph
77e5b91bbc Update docs for bup user home in /opt/backups
We're now putting bup backups into /opt/backups on a cinder
volume, updating documentation to move home directories for
servers we back up here.

Change-Id: I81e68dfb3fd9fd92dfb41ea3415a44db37f6c3af
2015-02-27 09:45:18 -08:00
Elizabeth K. Joseph
07fd18e754 Add instructions for vgcreate to sysadmin docs
The current sysadmin.html assumes there is a volume group (vg) present
when adding a new cinder volume. On a new server a vg won't exist, adding
instructions for how to add it.

Change-Id: I3171819fb5aea8a5edfab28f29ba35f9d0f5d461
2015-02-26 16:48:41 -08:00
James E. Blair
26aae7f49f Document how to disable/enable puppet
Change-Id: Id1f86c52727bac2403261083b55d89ab487fea10
2015-01-09 14:36:09 -08:00
Andreas Jaeger
e74e0cb50c Clarify puppet apply iteration docu
Clarify that only puppet apply needs to be iterated.

Change-Id: I6bad606506dca3ba9a97a48f64c6283dea0b4404
2014-12-04 19:01:54 +01:00
Andreas Jaeger
168254f154 Replace links to GerritWorkflow
Replace links to wiki article with link to infra-manual.

Change-Id: I574a30a44b0683ecf4914f1d5aef741b93d05016
2014-12-03 21:15:21 +01:00
Anita Kuno
8549f5d29e Rename config => system-config in docs
We are renaming the openstack-infra/config repo to
openstack-infra/system-config. This patch edits the docs files.

Change-Id: Ic594f1b5438a400fb6c1071c3045adb7a0b7e441
2014-10-17 15:05:29 -04:00
Jeremy Stanley
6585339b56 Update config documentation to refer to new master
Change-Id: I9072e866e47587d2de7e6d3c8f1e264d91a0d389
2014-09-15 20:48:33 +00:00
James E. Blair
c19da4c8a7 Move cinder docs into sysadmin section
And reference them from hosts that use cinder volumes.

Change-Id: I180f13a44d8e45209df8c6a16f275d987d05cbfe
2014-04-24 14:18:18 -07:00
James E. Blair
56562d83f7 Revert "Adds second hiera data directory"
This did not seem to work.

This reverts commit ed57cef9c5a65f429e07ce253668cd23ceb6c45a
2014-03-31 21:06:37 +00:00