readme.md 1.86 KB
Newer Older
1
2
3
4
# Baseimage for Jekyll@LCSB
A Docker base-image containing Ruby dependencies for Jekyll instances using Jekyll-LCSB-Theme.

# Versions
5
6
|   Tag             | Jekyll version | Bundler version | Theme version |
|:-----------------:|:--------------:|-----------------|---------------|
Jacek Lebioda's avatar
Jacek Lebioda committed
7
8
| 1.5 (or latest)   |   Jekyll 4.0.0 | 2.1.4           | 0.3.18        |
| 1.4               |   Jekyll 4.0.0 | 2.0.2           | 0.3.6         |
Jacek Lebioda's avatar
Jacek Lebioda committed
9
| 1.3               |   Jekyll 4.0.0 | 2.0.2           | 0.3.3         |
Jacek Lebioda's avatar
Jacek Lebioda committed
10
| 1.2               |   Jekyll 4.0.0 | 2.0.2           | 0.3.3         |
Jacek Lebioda's avatar
Jacek Lebioda committed
11
| 1.1               |   Jekyll 4.0.0 | 2.0.2           | 0.3.3         |
12
| 1.0               |   Jekyll 4.0.0 | 2.0.2           | 0.3.0         |
Jacek Lebioda's avatar
Jacek Lebioda committed
13
| 0.1 (or legacy)   |   Jekyll 3.8.6 | 1.17.3          | 0.3.0         |
14
15

# How to use?
Jacek Lebioda's avatar
Jacek Lebioda committed
16
In your `.gitlab-ci.yml` file add the following line (make sure `r3` is written in lower-case):
17
18

```
Jacek Lebioda's avatar
Jacek Lebioda committed
19
20
21
22
image: git-r3lab.uni.lu:4567/r3/docker/jekyll-lcsb:latest

# or, if you want to use legacy (or other versions) 
image: git-r3lab.uni.lu:4567/r3/docker/jekyll-lcsb:0.1
23
24
```

Jacek Lebioda's avatar
Jacek Lebioda committed
25
26
For the reproducibility, it's good if you pin the version to a specific tag, e.g. `1.3` instead of `latest`.

27
# How to build and push to the repository?
Jacek Lebioda's avatar
Jacek Lebioda committed
28
29
30
31
32
33
34
35
36
37
38
It is handled by gitlab-CI automatically (see `.gitlab-ci.yml`) when you tag the commit.

Anyway, if you'd like to do it yourself, perform these steps:

Login to gitlab registry (you can generate the token to login with https://docs.gitlab.com/ee/user/profile/personal_access_tokens.html).

```
docker login git-r3lab.uni.lu:4567
```

Then, build the image:
39
40

```
Jacek Lebioda's avatar
Jacek Lebioda committed
41
42
# replace `new_tag` with e.g. 1.3, and don't forget the dot...
docker build -t git-r3lab.uni.lu:4567/r3/docker/jekyll-lcsb:new_tag .  # ...there
Jacek Lebioda's avatar
Jacek Lebioda committed
43
docker build -t git-r3lab.uni.lu:4567/r3/docker/jekyll-lcsb:latest .
44
45
46
47
48
```

Publish in repository:

```
Jacek Lebioda's avatar
Jacek Lebioda committed
49
docker push git-r3lab.uni.lu:4567/r3/docker/jekyll-lcsb
50
```