From 745ab255492149bbb4e71841710b3674bab8f92b Mon Sep 17 00:00:00 2001 From: Steffen Ritter Date: Sun, 6 Aug 2023 12:33:07 +0200 Subject: Push guacamole version --- deployment/docker/.env.example | 2 +- deployment/docker/README | 48 ------------------------------------------ deployment/docker/README.md | 48 ++++++++++++++++++++++++++++++++++++++++++ 3 files changed, 49 insertions(+), 49 deletions(-) delete mode 100644 deployment/docker/README create mode 100644 deployment/docker/README.md diff --git a/deployment/docker/.env.example b/deployment/docker/.env.example index d33499c..181dedc 100644 --- a/deployment/docker/.env.example +++ b/deployment/docker/.env.example @@ -1,4 +1,4 @@ -VERSION=1.5.2 +VERSION=1.5.3 PORT=8080 SLX_CLIENT_LIST_URL=https://10.9.8.7/slx-admin/api.php?do=remoteaccess diff --git a/deployment/docker/README b/deployment/docker/README deleted file mode 100644 index c6890bc..0000000 --- a/deployment/docker/README +++ /dev/null @@ -1,48 +0,0 @@ -## README - -This is a basic skeleton for deploying [Apache -Guacamole](https://guacamole.apache.org/) for bwLehrpool remote access with -docker containers. It consists of two containers. One for guacd and one for -guacamole. - -First, copy *.env.example* to *.env* - - cp .env.example .env - -Edit the file and set at least which Guacamole version to use and the IP or -hostname of your satelliteserver in SLX_CLIENT_LIST_URL. You can also set a -different port, if there is already another service using that one. - -To configure LDAP login you need to set some more variables. There are -additional configuration options available if needed. -https://guacamole.apache.org/doc/gug/guacamole-docker.html#ldap-authentication - -**Optional:** It may be necessary to import a ssl-certificate for your -ldap-server in the guacamole container if you have a custom CA or a self-signed -cert. This can be done whilst building the container through the 'Dockerfile'. -Uncomment and adapt the last few lines to your needs. If you don't need a -special cert, you can skip that step. - -The 'data' directory will be mounted in the container. Place the -bwlp-guac-plugin which corresponds to your guacamole version in -'./data/extensions/'. You can find all currently for download available plugins -under https://files.bwlp.ks.uni-freiburg.de/satellit/guacamole/ - -Make sure, that there is **only one** bwlp-guac-plugin in the extension folder -at the same time! - -To start the containers simply type - - docker compose up --build -d - -To check if both containers are running or to inspect runtime logs you can use - - docker ps docker logs -f ---- - -If you want to update to a newer version of Guacamole just edit the '.env' file, -replace the bwlp-guac-plugin with the new one matching your wanted Guacamole -version and restart the containers with - - docker compose up --build --force-recreate -d - diff --git a/deployment/docker/README.md b/deployment/docker/README.md new file mode 100644 index 0000000..c6890bc --- /dev/null +++ b/deployment/docker/README.md @@ -0,0 +1,48 @@ +## README + +This is a basic skeleton for deploying [Apache +Guacamole](https://guacamole.apache.org/) for bwLehrpool remote access with +docker containers. It consists of two containers. One for guacd and one for +guacamole. + +First, copy *.env.example* to *.env* + + cp .env.example .env + +Edit the file and set at least which Guacamole version to use and the IP or +hostname of your satelliteserver in SLX_CLIENT_LIST_URL. You can also set a +different port, if there is already another service using that one. + +To configure LDAP login you need to set some more variables. There are +additional configuration options available if needed. +https://guacamole.apache.org/doc/gug/guacamole-docker.html#ldap-authentication + +**Optional:** It may be necessary to import a ssl-certificate for your +ldap-server in the guacamole container if you have a custom CA or a self-signed +cert. This can be done whilst building the container through the 'Dockerfile'. +Uncomment and adapt the last few lines to your needs. If you don't need a +special cert, you can skip that step. + +The 'data' directory will be mounted in the container. Place the +bwlp-guac-plugin which corresponds to your guacamole version in +'./data/extensions/'. You can find all currently for download available plugins +under https://files.bwlp.ks.uni-freiburg.de/satellit/guacamole/ + +Make sure, that there is **only one** bwlp-guac-plugin in the extension folder +at the same time! + +To start the containers simply type + + docker compose up --build -d + +To check if both containers are running or to inspect runtime logs you can use + + docker ps docker logs -f +--- + +If you want to update to a newer version of Guacamole just edit the '.env' file, +replace the bwlp-guac-plugin with the new one matching your wanted Guacamole +version and restart the containers with + + docker compose up --build --force-recreate -d + -- cgit v1.2.3-55-g7522