readme.md 2.48 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
Jacek Lebioda's avatar
Jacek Lebioda committed
5
6
|   Tag             | Jekyll version | Bundler version | Theme version | Additional |
|:-----------------:|:--------------:|-----------------|---------------|------------|
Jacek Lebioda's avatar
Jacek Lebioda committed
7
8
| 1.8 (or latest)   |   Jekyll 4.2.0 | 2.1.4           | 0.3.18        | Spaceship  |
| 1.7               |   Jekyll 4.1.1 | 2.1.4           | 0.3.18        | Spaceship  |
Jacek Lebioda's avatar
Jacek Lebioda committed
9
10
11
12
13
14
15
16
17
18
| 1.6               |   Jekyll 4.0.0 | 2.1.4           | 0.3.18        | Spaceship  |
| 1.5               |   Jekyll 4.0.0 | 2.1.4           | 0.3.18        |            |
| 1.4               |   Jekyll 4.0.0 | 2.0.2           | 0.3.6         |            |
| 1.3               |   Jekyll 4.0.0 | 2.0.2           | 0.3.3         |            |
| 1.2               |   Jekyll 4.0.0 | 2.0.2           | 0.3.3         |            |
| 1.1               |   Jekyll 4.0.0 | 2.0.2           | 0.3.3         |            |
| 1.0               |   Jekyll 4.0.0 | 2.0.2           | 0.3.0         |            |
| 0.1 (or legacy)   |   Jekyll 3.8.6 | 1.17.3          | 0.3.0         |            |

# How to use? (for developers of applications using the image)
Jacek Lebioda's avatar
Jacek Lebioda committed
19
In your `.gitlab-ci.yml` file add the following line (make sure `r3` is written in lower-case):
20
21

```
Jacek Lebioda's avatar
Jacek Lebioda committed
22
23
24
25
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
26
27
```

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

Jacek Lebioda's avatar
Jacek Lebioda committed
30
31
32
33
34
# How to update this repository (for developers of this repository)
Locally, change `Gemfile` and run `bundle update`. Commit `Gemfile.lock`, and tag the commit.

# How to build and push to the repository manually? (for developers of this repository)
Normally it is handled by gitlab-CI automatically (see `.gitlab-ci.yml`) when you tag the commit.
Jacek Lebioda's avatar
Jacek Lebioda committed
35
36
37
38
39
40
41
42
43
44

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:
45
46

```
Jacek Lebioda's avatar
Jacek Lebioda committed
47
48
# 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
49
docker build -t git-r3lab.uni.lu:4567/r3/docker/jekyll-lcsb:latest .
50
51
52
53
54
```

Publish in repository:

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