README.md 4.12 KB
Newer Older
Sven-Hendrik Haase's avatar
Sven-Hendrik Haase committed
1
2
3
4
# Arch Infrastructure

This repository contains the complete collection of ansible playbooks and roles for the Arch Linux infrastructure.

5
6
7
It also contains git submodules so you have to run `git submodule update --init
--recursive` after cloning or some tasks will fail to run.

8
9
## Requirements

10
11
12
Install these packages:
- ansible-git
- terraform-git
13
- terraform-provider-hcloud-snapshot
14

15
16
17
For the time being, to run all of this you'll need terraform-git because of the pg backend and ansible-git because of the dynamic hcloud provider module.
This is temporary and the next releases of these packages will contain the modules in a stable version.

Sven-Hendrik Haase's avatar
Sven-Hendrik Haase committed
18
19
#### Instructions
All systems are set up the same way. For the first time setup in the Hetzner rescue system,
20
run the provisioning script: `ansible-playbook playbooks/tasks/install-arch.yml -l $host`.
Sven-Hendrik Haase's avatar
Sven-Hendrik Haase committed
21
22
23
The provisioning script configures a sane basic systemd with sshd. By design, it is NOT idempotent.
After the provisioning script has run, it is safe to reboot.

24
25
Once in the new system, run the regular playbook: `HCLOUD_TOKEN=$(misc/get_hcloud_api_key_ansible.sh) ansible-playbook playbooks/$hostname.yml`.
This playbook is the one regularity used for administrating the server and is entirely idempotent.
Sven-Hendrik Haase's avatar
Sven-Hendrik Haase committed
26

27
28
29
30
31
32
##### Note about first time certificates

The first time a certificate is issued, you'll have to do this manually by yourself. First, configure the DNS to
point to the new server and then run a playbook onto the server which includes the nginx role. Then on the server,
it is necessary to run the following once:

Sven-Hendrik Haase's avatar
Sven-Hendrik Haase committed
33
    certbot certonly --email webmaster@archlinux.org --agree-tos --rsa-key-size 4096 --renew-by-default --webroot -w /var/lib/letsencrypt/ -d <domain-name>
34

35
36
Note that some roles already run this automatically.

Sven-Hendrik Haase's avatar
Sven-Hendrik Haase committed
37
38
39
40
41
##### Note about packer

We use packer to build snapshots on hcloud to use as server base images.
In order to use this, you need to install packer and then run

42
	packer build -var $(./misc/get_hcloud_api_key_packer.sh) packer/archlinux.json
Sven-Hendrik Haase's avatar
Sven-Hendrik Haase committed
43
44
45

This will take some time after which a new snapshot will have been created on the primary hcloud archlinux project.

46
47
48
49
50
##### Note about terraform

We use terraform to provision a part of the infrastructure on hcloud.
In order to use this, you need to install terraform and then run

51
    terraform plan -var $(./misc/get_hcloud_api_key_packer.sh) terraform
52
53
54
55

This will show you planned changes between the current infrastructure and the desired infrastructure.
You can then run

56
    terraform apply -var $(./packer/get_hcloud_api_key_packer.sh) terraform
57
58
59

to actually apply your changes.

60
61
62
63
64
65
##### Note about opendkim

The opendkim DNS data has to be added to DNS manually. The roles verifies that the DNS is correct before starting opendkim.

The file that has to be added to the zone is `/etc/opendkim/private/$selector.txt`.

66
67
68
69
70
71
72

### Finding servers requiring security updates

Arch-audit can be used to find servers in need of updates for security issues.

    ansible all -a "arch-audit -u"

73
74
75
76
77
#### Updating servers

The following steps should be used to update our managed servers:

* pacman -Syu
78
* manually update the kernel, since it is in IgnorePkg by default
79
80
81
82
* sync
* checkservices
* reboot

Sven-Hendrik Haase's avatar
Sven-Hendrik Haase committed
83
84
85
86
87
88
89
90
91
92
93
## Servers

### vostok

#### Services
- backups

### orion

#### Services
- repos/sync (repos.archlinux.org)
94
- sources (sources.archlinux.org)
Sven-Hendrik Haase's avatar
Sven-Hendrik Haase committed
95
- archive (archive.archlinux.org)
96
- torrent tracker hefurd (tracker.archlinux.org)
Sven-Hendrik Haase's avatar
Sven-Hendrik Haase committed
97
98
99
100
101
102
103

### apollo

#### Services
- bbs (bbs.archlinux.org)
- wiki (wiki.archlinux.org)
- aur (aur.archlinux.org)
Jelle van der Waa's avatar
Jelle van der Waa committed
104
- flyspray (bugs.archlinux.org)
Sven-Hendrik Haase's avatar
Sven-Hendrik Haase committed
105
- mailman
Sven-Hendrik Haase's avatar
Sven-Hendrik Haase committed
106
- planet (planet.archlinux.org)
Sven-Hendrik Haase's avatar
Sven-Hendrik Haase committed
107
108
109
- bugs (bugs.archlinux.org)
- archweb
- patchwork
Sven-Hendrik Haase's avatar
Sven-Hendrik Haase committed
110
- projects (projects.archlinux.org)
Sven-Hendrik Haase's avatar
Sven-Hendrik Haase committed
111
112
113
114
115
116

### soyuz

#### Services
- build server (pkgbuild.com)
- releng
117
118
119
120
- sogrep
- /~user/ webhost
- irc bot (phrik)
- quassel core
Jelle van der Waa's avatar
Jelle van der Waa committed
121
122
123
- matrix
- docker images
- arch boxes (packer)
124
125
126
127
128
129
130
131
132
133
134


## Ansible repo workflows

### Replace vault password and change vaulted passwords

 - Generate a new key and save it as ./new-vault-pw: `pwgen -s 64 1 > new-vault-pw`
 - `for i in $(ag ANSIBLE_VAULT -l); do ansible-vault rekey --new-vault-password-file new-vault-pw $i; done`
 - Change the key in misc/vault-password.gpg
 - `rm new-vault-pw`