readme.md 1.45 KB
Newer Older
Aral Balkan's avatar
Aral Balkan committed
1
2
3
# Blockdown Builder

Builds the blockdown data from the blockdown content.
4

5
6
7
8
9
10
11
12
13
14
15
16
# Development

1. Copy `config.coffee` into `~/ind.ie.blockdown-builder` and configure it.

2. In the folder from Step 1, above, `git clone git@source.ind.ie:blockdown/content-dev.git`

3. Create the data repository:
	i. `cd ~/ind.ie.blockdown-builder/`
	ii. `git clone git@source.ind.ie:blockdown/data-dev.git`

Note that the repositories we use for development are `content-dev` and `data-dev` and the ones we use for deployment, below, are `content` and `dev`.

17
18
4. Add your ssh key for the Blockdown repositories to `~/ind.ie.blockdown-builder/ssh` as `id_rsa` and `id_rsa.pub`.

19
20
21
# Deployment

1. Set up server with Dokku.
22

23
2. Copy `config.coffee` into `~/ind.ie.blockdown-builder` (`/root/ind.ie.blockdown-builder/`) and configure it.
24

25
3. In the folder from Step 2, above, `git clone git@source.ind.ie:blockdown/content.git`
26

27
28
4. ./deploy

29
30
31
5. Create the volumes:

		dokku docker-options:add blockdown-builder.ind.ie run "-v /root/ind.ie.blockdown-builder:/app/ind.ie.blockdown-builder"
32

33
34
35
6. Create the data repository:
	i. `cd ~/ind.ie.blockdown-builder/`
	ii. `git clone git@source.ind.ie:blockdown/data.git`
36

37
7. Set up post-push and post-merge webhooks on Gitlab for both the Builder and Content repositories to point to `https://url/for/your/installation/build/(token-from-config.coffee)`
38

39
40
8. Add your ssh key for the Blockdown repositories to `~/ind.ie.blockdown-builder/ssh` as `id_rsa` and `id_rsa.pub`.