Skip to content

Commit ed57197

Browse files
supertassumgol
authored andcommitted
doc: document host decom
1 parent 4734c1e commit ed57197

File tree

2 files changed

+17
-3
lines changed

2 files changed

+17
-3
lines changed

doc/backup.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -40,12 +40,15 @@ To add a new host, run the following script as your own user on the Puppet serve
4040
$ jq-tarsnap-keygen FULL-HOSTNAME.ops.jquery.net
4141
```
4242

43-
To delete a host, login to the host in question and run:
43+
To delete a host, follow the decom host procedure in [puppet.md]. Alternatively, login to the host
44+
in question and run:
4445

4546
```shell-session
4647
$ tarsnap --nuke
4748
```
4849

50+
[puppet.md]: ./puppet.md
51+
4952
This will ask for confirmation and then automatically enumerate each backup (`sudo tarsnap --list-archives`) and delete it (`sudo tarsnap -d -f <entry>`).
5053

5154
## Retention policy

doc/puppet.md

Lines changed: 13 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -9,14 +9,25 @@ However, if you need to manually run Puppet, there is a wrapper script
99
called `run-puppet-agent` that should be used instead of directly
1010
executing `puppet agent -tv`.
1111

12-
## Provisioning new nodes
12+
## Managing nodes
13+
14+
### Provisioning new nodes
1315

1416
Add the instance to `site.pp`, push the commit and then use the
1517
`bin/provision-instance.sh` script on your local machine:
16-
```bash
18+
```shell-session
1719
$ bin/provision-instance.sh codeorigin-02.stage.ops.jquery.net staging
1820
```
1921

22+
### Decomissioning new nodes
23+
24+
To decom a node, run the following script as your own user on the
25+
Puppet server:
26+
```shell-session
27+
$ jq-decom-instance FULL-HOSTNAME.ops.jquery.net
28+
```
29+
Then remove references from `site.pp`, host-specific hiera files, etc.
30+
2031
## Conventions
2132

2233
This section documents some conventions that are in place on this

0 commit comments

Comments
 (0)