Rundeck server based on Debian
Jacek Kowalski
2020-03-11 021a4d4dddd989cbce16a45a7b9040be9e8c0924
commit | author | age
8e0d28 1 # Rundeck
JK 2
7ca149 3 This is a Docker image of Rundeck (http://rundeck.org)
JK 4 based on `debian:latest`
5
d6614a 6 ## Upgrading
JK 7
8 Since version 3.0 /etc/rundeck/profile will be overriden!
9 To customize JVM options use environment variable:
10 `RDECK_JVM_SETTINGS`. See section "Configuration" below.
11
7ca149 12 ## Usage
JK 13
14 ```bash
15 docker run -d --name=rundeck -p 4440:4440 jacekkow/rundeck
16 ```
17
18 Rundeck should be available at http://127.0.0.1:4440/
8e0d28 19 (user/password pairs: `user`/`user` and `admin`/`admin`)
7ca149 20
JK 21 By default it uses H2 database and Docker data volumes
22 for storage persistence.
23
24 You can update such installation by passing
25 `--volumes-from` to `docker run`:
26
27 ```bash
28 docker stop rundeck
29 docker rename rundeck rundeck-old
30 docker run -d --name=rundeck -p 4440:4440 \
31     --volumes-from rundeck-old \
32     jacekkow/rundeck
33 docker rm -v rundeck-old
34 ```
35
36 ### Local volumes
37
d6614a 38 You can use local storage instead of data volumes:
7ca149 39
JK 40 ```bash
41 docker run -d --name=rundeck -p 4440:4440 \
42     -v /srv/rundeck/etc:/etc/rundeck \
43     -v /srv/rundeck/data:/var/lib/rundeck/data \
44     -v /srv/rundeck/logs:/var/lib/rundeck/logs \
45     -v /srv/rundeck/rundeck:/var/rundeck \
46     -v /srv/rundeck/ssh:/var/lib/rundeck/.ssh \
47     jacekkow/rundeck
48 ```
49
50 ### External database
51
52 To increase performance, use MySQL instead of H2 database:
53
54 ```bash
55 docker run -d --name=rundeck-db \
56     -e MYSQL_ROOT_PASSWORD=root-pass \
57     -e MYSQL_USER=rundeck \
58     -e MYSQL_PASSWORD=rundeck-pass \
59     -e MYSQL_DATABASE=rundeck \
60     mariadb
61 docker run -d --name=rundeck -p 4440:4440 \
62     -v /srv/rundeck/etc:/etc/rundeck \
63     -v /srv/rundeck/data:/var/lib/rundeck/data \
64     -v /srv/rundeck/logs:/var/lib/rundeck/logs \
65     -v /srv/rundeck/rundeck:/var/rundeck \
66     -v /srv/rundeck/ssh:/var/lib/rundeck/.ssh \
67     --link rundeck-db:rundeck-db \
68     jacekkow/rundeck
69 ```
70
71 Then set the following options in
8e0d28 72 `/srv/rundeck/etc/rundeck-config.properties`
7ca149 73
JK 74 ```
75 dataSource.url = jdbc:mysql://rundeck-db/rundeck?autoReconnect=true
76 dataSource.username = rundeck
77 dataSource.password = rundeck-pass
78 ```
79
80 and restart the container:
81
82 ```bash
83 docker restart rundeck
84 ```
85
86 ## Configuration
87
88 You can change Java system properties and JVM options by modifying
d6614a 89 `RDECK_JVM_SETTINGS` environment variable, which defaults to:
JK 90
91 ```
92 -Xmx1024m -Xms256m -XX:MaxMetaspaceSize=256m -server
93 ```
94
95 Sample:
96
97 ```
98 docker run -d --name=rundeck -p 4440:4440 \
99     -v /srv/rundeck/etc:/etc/rundeck \
100     -v /srv/rundeck/data:/var/lib/rundeck/data \
101     -v /srv/rundeck/logs:/var/lib/rundeck/logs \
102     -v /srv/rundeck/rundeck:/var/rundeck \
103     -v /srv/rundeck/ssh:/var/lib/rundeck/.ssh \
104     -e RDECK_JVM_SETTINGS="-Xms1024m -Xmx1024" \
105     jacekkow/rundeck
106 ```