readme.md 1.72 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.3 (or latest)   |   Jekyll 4.0.0 | 2.0.2           | 0.3.3         |
| 1.2               |   Jekyll 4.0.0 | 2.0.2           | 0.3.3         |
Jacek Lebioda's avatar
Jacek Lebioda committed
9
| 1.1               |   Jekyll 4.0.0 | 2.0.2           | 0.3.3         |
10
| 1.0               |   Jekyll 4.0.0 | 2.0.2           | 0.3.0         |
Jacek Lebioda's avatar
Jacek Lebioda committed
11
| 0.1 (or legacy)   |   Jekyll 3.8.6 | 1.17.3          | 0.3.0         |
12
13

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

```
Jacek Lebioda's avatar
Jacek Lebioda committed
17
18
19
20
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
21
22
```

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

25
# How to build and push to the repository?
Jacek Lebioda's avatar
Jacek Lebioda committed
26
27
28
29
30
31
32
33
34
35
36
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:
37
38

```
Jacek Lebioda's avatar
Jacek Lebioda committed
39
40
# 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
41
docker build -t git-r3lab.uni.lu:4567/r3/docker/jekyll-lcsb:latest .
42
43
44
45
46
```

Publish in repository:

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