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