Skip to content

Commit bdb1f93

Browse files
Bot Updating Templated Files
1 parent df258f8 commit bdb1f93

File tree

2 files changed

+35
-1
lines changed

2 files changed

+35
-1
lines changed

Jenkinsfile

+9
Original file line numberDiff line numberDiff line change
@@ -211,6 +211,15 @@ pipeline {
211211
else
212212
echo "false" > /tmp/${COMMIT_SHA}-${BUILD_NUMBER}
213213
fi
214+
mkdir -p ${TEMPDIR}/gitbook
215+
git clone https://github.com/linuxserver/docker-documentation.git ${TEMPDIR}/gitbook/docker-documentation
216+
if [ "${BRANCH_NAME}" = "master" ] && [ ! -f ${TEMPDIR}/gitbook/docker-documentation/images/docker-${CONTAINER_NAME}.md ] || [ "$(md5sum ${TEMPDIR}/gitbook/docker-documentation/images/docker-${CONTAINER_NAME}.md | awk '{ print $1 }')" != "$(md5sum ${TEMPDIR}/${CONTAINER_NAME}/docker-${CONTAINER_NAME}.md | awk '{ print $1 }')" ]; then
217+
cp ${TEMPDIR}/${CONTAINER_NAME}/docker-${CONTAINER_NAME}.md ${TEMPDIR}/gitbook/docker-documentation/images/
218+
cd ${TEMPDIR}/gitbook/docker-documentation/
219+
git add images/docker-${CONTAINER_NAME}.md
220+
git commit -m 'Bot Updating Templated Files'
221+
git push https://LinuxServer-CI:${GITHUB_TOKEN}@github.com/linuxserver/docker-documentation.git --all
222+
fi
214223
rm -Rf ${TEMPDIR}'''
215224
script{
216225
env.FILES_UPDATED = sh(

README.md

+26-1
Original file line numberDiff line numberDiff line change
@@ -26,6 +26,8 @@ TLDR: Multi-arch support is changing from multiple repos to one repo per contain
2626
[![](https://images.microbadger.com/badges/image/linuxserver/bookstack.svg)](https://microbadger.com/images/linuxserver/bookstack "Get your own version badge on microbadger.com")
2727
![Docker Pulls](https://img.shields.io/docker/pulls/linuxserver/bookstack.svg)
2828
![Docker Stars](https://img.shields.io/docker/stars/linuxserver/bookstack.svg)
29+
[![Build Status](https://ci.linuxserver.io/buildStatus/icon?job=Docker-Pipeline-Builders/docker-bookstack/master)](https://ci.linuxserver.io/job/Docker-Pipeline-Builders/job/docker-bookstack/job/master/)
30+
[![](https://lsio-ci.ams3.digitaloceanspaces.com/linuxserver/bookstack/latest/badge.svg)](https://lsio-ci.ams3.digitaloceanspaces.com/linuxserver/bookstack/latest/index.html)
2931

3032
[Bookstack](https://github.com/BookStackApp/BookStack) is a free and open source Wiki designed for creating beautiful documentation. Feautring a simple, but powerful WYSIWYG editor it allows for teams to create detailed and useful documentation with ease.
3133

@@ -40,6 +42,8 @@ For more information on BookStack visit their website and check it out: https://
4042

4143
Our images support multiple architectures such as `x86-64`, `arm64` and `armhf`. We utilise the docker manifest for multi-platform awareness. More information is available from docker [here](https://github.com/docker/distribution/blob/master/docs/spec/manifest-v2-2.md#manifest-list).
4244

45+
Simply pulling `linuxserver/bookstack` should retrieve the correct image for your arch, but you can also pull specific arch images via tags.
46+
4347
The architectures supported by this image are:
4448

4549
| Architecture | Tag |
@@ -48,6 +52,7 @@ The architectures supported by this image are:
4852
| arm64 | arm64v8-latest |
4953
| armhf | arm32v6-latest |
5054

55+
5156
## Usage
5257

5358
Here are some example snippets to help you get started creating a container.
@@ -127,6 +132,7 @@ In this instance `PUID=1001` and `PGID=1001`, to find yours use `id user` as bel
127132
uid=1001(dockeruser) gid=1001(dockergroup) groups=1001(dockergroup)
128133
```
129134

135+
130136
 
131137
## Application Setup
132138

@@ -140,7 +146,7 @@ Once the MariaDB container is deployed, you can enter the following commands int
140146
from shell: mysql -u root -p
141147
CREATE DATABASE bookstackapp;
142148
GRANT USAGE ON *.* TO 'myuser'@'%' IDENTIFIED BY 'mypassword';
143-
GRANT ALL privileges ON `bookstackapp`.* TO 'myuser'@'%';
149+
GRANT ALL privileges ON `bookstackapp`.* TO 'myuser'@%;
144150
FLUSH PRIVILEGES;
145151
```
146152

@@ -174,6 +180,25 @@ Some simple docker-compose files are included for you to get started with. You w
174180
* image version number
175181
* `docker inspect -f '{{ index .Config.Labels "build_version" }}' linuxserver/bookstack`
176182

183+
## Updating Info
184+
185+
Most of our images are static, versioned, and require an image update and container recreation to update the app inside. With some exceptions (ie. nextcloud, plex), we do not recommend or support updating apps inside the container. Please consult the [Application Setup](#application-setup) section above to see if it is recommended for the image.
186+
187+
Below are the instructions for updating containers:
188+
189+
### Via Docker Run/Create
190+
* Update the image: `docker pull linuxserver/bookstack`
191+
* Stop the running container: `docker stop bookstack`
192+
* Delete the container: `docker rm bookstack`
193+
* Recreate a new container with the same docker create parameters as instructed above (if mapped correctly to a host folder, your `/config` folder and settings will be preserved)
194+
* Start the new container: `docker start bookstack`
195+
* You can also remove the old dangling images: `docker image prune`
196+
197+
### Via Docker Compose
198+
* Update the image: `docker-compose pull linuxserver/bookstack`
199+
* Let compose update containers as necessary: `docker-compose up -d`
200+
* You can also remove the old dangling images: `docker image prune`
201+
177202
## Versions
178203

179204
* **20.01.19:** - Added php7-curl

0 commit comments

Comments
 (0)