Enterprise Deployment
Running from Docker
The CloudBeaver EE container image is at DockerHub: https://hub.docker.com/r/dbeaver/cloudbeaver-ee.
- dbeaver/cloudbeaver-ee:latest - latest release build.
- dbeaver/cloudbeaver:x.y.z - particular product version.
It is a public repository so you can just pull it.
Installation
To install the latest version of CloudBeaver EE use the following script:
Running
To run cloudbeaver in terminal:
sudo docker run --name cloudbeaver-ee --rm -ti -p 8080:8978 -v /var/cloudbeaver-ee/workspace:/opt/cloudbeaver/workspace dbeaver/cloudbeaver-ee:latest
Then switch to the browser and open http://localhost:8080/
To run the server in daemon mode, add the following parameters:
Accessing databases on the localhost
If you need to access the database server on the host machine, add the following parameter in docker run: (on Linux only)
Cloudbeaver will work in the host machine network. If this mode is not suitable for your network environment then you can run the container in the following way:
export CB_LOCAL_HOST_ADDR=$(ifconfig | grep -E "([0-9]{1,3}\..md){3}[0-9]{1,3}" | grep -v 127.0.0.1 | awk '{ print $2 }' | cut -f2 -d: | head -n1)
docker run --name cloudbeaver-ee -d --restart unless-stopped -ti -p 8080:8978 --add-host=host.docker.internal:${CB_LOCAL_HOST_ADDR} -v /var/cloudbeaver-ee/workspace:/opt/cloudbeaver/workspace dbeaver/cloudbeaver-ee:latest
deploy/docker/run-docker-container.sh.
It passes the IP address of the host machine to the container.
Docker parameters explanation
Parameters explanation:
| Parameter | Explanation |
|---|---|
| --name cloudbeaver-ee | Assign container ID (cloudbeaver-ee.md) |
| --rm | Removes container on stop |
| -ti | Enables terminal mode (allows to stop container with CTRL+C) |
| -p 8080:8978 | Maps CloudBeaver public port (8978.md) to the host machine port (e.g. 8080) |
| -v local_path:/opt/cloudbeaver-ee/workspace | Mounts local folder `/var/cloudbeaver-ee/workspace' to the server workspace. Required to keep CloudBeaver EE data after container restart. |
| --add-host=host.docker.internal:IP address | Adds host name in the container's /etc/hosts file. This may be needed to access the database server deployed on the host machine. |
| dbeaver/cloudbeaver-ee:latest | Container ID |
Offline upgrading method
On host with internet access you need to download and archve image:
Note: you can change latest tag to desired version
docker pull dbeaver/cloudbeaver-ee:latest
docker save dbeaver/cloudbeaver-ee | gzip > cloudbeaver-ee.latest.tar.gz
Check that na archive exist:
Output should looks like:
Now copy file cloudbeaver-ee.latest.tar.gz to some external drive and put to server with running cloudbeaver server.
Load image from archve:
You will see next outputUpgrade your cloudbeaver-ee server:
docker stop cloudbeaver-ee
docker rm cloudbeaver-ee
docker run -d --restart unless-stopped -p 8978:8978 -v /var/cloudbeaver-ee/workspace:/opt/cloudbeaver/workspace dbeaver/cloudbeaver-ee:<VERSION>
Info
Note: some of docker args may differ from your environment.