| 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 | ``` | |
