On-Premise Team Installation

The DeployHub Team on-prem runs as docker container.  In order to install it you need to have docker up and running.

Docker Installation

• Docker for Windows​

• Requires Microsoft Windows 10 Professional or Enterprise 64-bit

• Docker for CentOS

• Requires CentOS 64-bit 7.1 and higher on x86_64

• Docker for RedHat

• Require RHEL 64-bit 7.1 and higher on x86_64, s390x, or ppc64le (not ppc64).

• Docker for Ubuntu

• Requires 64-bit version of one of these Ubuntu versions:
  • Bionic 18.04 (LTS)
  • Artful 17.10
  • Xenial 16.04 (LTS)
  • Trusty 14.04 (LTS)

• Docker for OS/X

• Requires macOS El Capitan 10.11 and newer macOS releases are supported. We recommend upgrading to the latest version of macOS.

• Test your Docker Install

DeployHub Team Installation

• DeployHub Team (OSS) Docker Image is found on the DockerHub Container Catalog
  and  Redhat Certified Container Catalog

• Pull DockerHub

• docker login registry.hub.docker.com
  docker pull registry.hub.docker.com/deployhub/deployhub

• Pull RedHat

• docker login registry.connect.redhat.com
  docker pull registry.connect.redhat.com/deployhub/deployhub

• Volume to access Jenkins build results

  • Linux and OS/X

  • docker volume create --name jenkinsfs --opt type=nfs --opt device=:/var/jenkins/jobs --opt o=addr=192.168.0.101

  • Windows

  • docker volume create --name jenkinsfs --driver local --opt type=cifs --opt device=//server/path/to/share --opt o=username=myuser,password=mypw,file_mode=0777,dir_mode=0777

• Make directory to persist database and logs

  •  Linux and OS/X

  • mkdir -p ~/deployhub/datamkdir -p ~/deployhub/logs

  • Windows

  • mkdir  "%APPDATA%\deployhub\data"
    mkdir  "%APPDATA%\deployhub\logs"

• Start the container

  • Linux and OS/X

  • docker run -v ~/deployhub/data:/var/lib/pgsql/data:Z -v ~/deployhub/logs:/opt/deployhub/logs:Z -p 7171:8080 -d --hostname docker_dh -v ~/.ssh:/keys:Z ${IMAGE}

  • Windows

  • docker run -v "%APPDATA%\deployhub\data:/var/lib/pgsql/data:Z" -v "%APPDATA%\deployhub\logs:/opt/deployhub/logs:Z" -p 7171:8080 -d --hostname docker_dh -v ~/.ssh:/keys:Z ${IMAGE}

• Volumes Used

  • jenkinsnfs:/jenkins is the Jenkins build results
  • ~/deplyohub/data:/var/lib/pgsql/data:Z is the persisted database
  • ~/deployhub/logs:/opt/deployhub/logs:Z is the persisted logs
  • ~/.ssh:/keys:Z users ssh keys made visible to the container for credentials

• Notes

  • ${IMAGE} = image id from the docker pull
  • NFS is share Jenkins Jobs directory
  • DeployHub will see the Jenkins File System Repository as /jenkins
  • DeployHub will see the ssh keys as /keys

Resources

• DeployHub Tutorials

• Support Questions and Issues