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

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

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

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

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

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

Publish in repository:

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