README.md 5.08 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
Install these packages:
Sven-Hendrik Haase's avatar
Sven-Hendrik Haase committed
11
- hcloud-python
12
- terraform-git
13
- terraform-provider-hcloud-snapshot
14

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

18
19
### Instructions

Sven-Hendrik Haase's avatar
Sven-Hendrik Haase committed
20
All systems are set up the same way. For the first time setup in the Hetzner rescue system,
21
run the provisioning script: `ansible-playbook playbooks/tasks/install-arch.yml -l $host`.
Sven-Hendrik Haase's avatar
Sven-Hendrik Haase committed
22
23
24
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.

25
26
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
27

28
29
30
31
32
33
34
35
#### Note about Ansible dynamic inventories

We use a dynamic inventory script in order to automatically get information for
all servers directly from hcloud. You don't really have to do anything to make
this work but you should keep in mind to NOT add hcloud servers to `hosts`!
They'll be available automatically.

#### Note about first time certificates
36
37
38
39
40

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
41
    certbot certonly --email webmaster@archlinux.org --agree-tos --rsa-key-size 4096 --renew-by-default --webroot -w /var/lib/letsencrypt/ -d <domain-name>
42

43
44
Note that some roles already run this automatically.

45
#### Note about packer
Sven-Hendrik Haase's avatar
Sven-Hendrik Haase committed
46
47
48
49

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

50
	packer build -var $(./misc/get_hetzner_cloud_api_key_packer.sh) packer/archlinux.json
Sven-Hendrik Haase's avatar
Sven-Hendrik Haase committed
51
52
53

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

54
#### Note about terraform
55
56

We use terraform to provision a part of the infrastructure on hcloud.
57
58
59
The very first time you run terraform on your system, you'll have to init it:

    terraform init -backend-config="conn_str=postgres://terraform:$(ansible-vault view group_vars/all/vault_terraform.yml | grep vault_terraform_db_password | cut -f2 -d'"')@state.cloud.archlinux.org"
60

61
62
63
After making changes to the infrastructure in `archlinux.fg`, run

    terraform plan
64
65
66
67

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

68
    terraform apply
69
70
71

to actually apply your changes.

72
73
74
75
76
77
78
We store terraform state on a special server that is the only hcloud server NOT
managed by terraform so that we do not run into a chicken-egg problem. The
state server is assumed to just exist so in an unlikely case where we have to
entirely redo this infrastructure, the state server would have to be manually
set up.

#### Note about opendkim
79
80
81
82
83

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`.

84
85
86
87
88
89
90

### 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"

91
92
93
94
95
#### Updating servers

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

* pacman -Syu
96
* manually update the kernel, since it is in IgnorePkg by default
97
98
99
100
* sync
* checkservices
* reboot

Sven-Hendrik Haase's avatar
Sven-Hendrik Haase committed
101
102
103
104
105
106
107
108
109
110
111
## Servers

### vostok

#### Services
- backups

### orion

#### Services
- repos/sync (repos.archlinux.org)
112
- sources (sources.archlinux.org)
Sven-Hendrik Haase's avatar
Sven-Hendrik Haase committed
113
- archive (archive.archlinux.org)
114
- torrent tracker hefurd (tracker.archlinux.org)
Sven-Hendrik Haase's avatar
Sven-Hendrik Haase committed
115
116
117
118
119
120
121

### 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
122
- flyspray (bugs.archlinux.org)
Sven-Hendrik Haase's avatar
Sven-Hendrik Haase committed
123
- mailman
Sven-Hendrik Haase's avatar
Sven-Hendrik Haase committed
124
- planet (planet.archlinux.org)
Sven-Hendrik Haase's avatar
Sven-Hendrik Haase committed
125
126
127
- bugs (bugs.archlinux.org)
- archweb
- patchwork
Sven-Hendrik Haase's avatar
Sven-Hendrik Haase committed
128
- projects (projects.archlinux.org)
Sven-Hendrik Haase's avatar
Sven-Hendrik Haase committed
129
130
131
132
133
134

### soyuz

#### Services
- build server (pkgbuild.com)
- releng
135
136
137
- sogrep
- /~user/ webhost
- irc bot (phrik)
Jelle van der Waa's avatar
Jelle van der Waa committed
138
139
140
- matrix
- docker images
- arch boxes (packer)
141

142
143
144
145
146
147
148
149
150
151
152
### dragon

#### Services
- build server (pkgbuild.com)
- sogrep

### state.cloud.archlinux.org

#### Services:
- postgres server for terraform state

153
154
155
156
### quassel.archlinux.org

#### Services:
- quassel core
157
158
159
160
161
162
163
164
165
166

## 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`