Categories

Versions

You are viewing the RapidMiner Deployment documentation for version 9.9 -Check here for latest version

Install Docker on Linux

If you are unfamiliar with Docker, you may believe that Docker will make your life more complicated. The truth is quite the opposite. Learn just a little about Docker, and you can easily deploy RapidMiner AI Hub, with all its integrated services, via a pre-configureddocker-compose template.

Three easy steps, and you're done: Docker does the rest!

  1. Ready-- For production purposes, you should install Docker on server hardware (or in thecloud), but you can experiment on your laptop.

  2. Set-- Choose a template for your RapidMiner AI Hub, depending on your needs:

    • choose one of severaltemplatesthat we provide, and
    • copy the template filesdocker-compose.ymland.envto the machine where you installed Docker.

    These files are pre-configured to work out of the box, but you can modify them to suit your preferences.

  3. Go!-- Follow thedetailed instructions, and execute thedocker-composecommands

  4. Docker automagically downloads theimagesyou need, and starts RapidMiner AI Hub.

Before you begin

The emphasis here is on installing Docker on Linux and deploying RapidMiner AI Hub as quickly as possible, using:

  1. theDocker quick & easy install script

  2. a variety ofdocker-compose templates.

We start with the following assumptions:

  • You have installed or have access to a Linux host,and

    • you can connect to the Linux host viassh,or
    • you have local access (so thatsshis unnecessary)
  • The hostname (or IP address) of the Linux host is
  • You haveroot(system administrator) access to the Linux host

All the commands will be issued from the command line, so a GUI is unnecessary. For security reasons you may prefer to run docker as an ordinary user, and assuming there is such a user, we'll call him .

The brackets here indicate that you must replace by the actual username and by the actual hostname or IP address of the host where RapidMiner AI Hub will be installed.

Download the Docker quick & easy install script

The quick & easy install script is also available ongithub.

The Docker installation script assumes there is no previous installation of Docker. If Docker is already installed, you can jump ahead todocker-compose templates. If an older version of Docker is installed, you should first uninstall it.

The script installs Docker CE (Community Edition), assuming you are using one of the following Linux distributions, or a derivative:

  • CentOS
  • Debian
  • Fedora
  • Oracle Linux
  • Red Hat
  • SUSE
  • Ubuntu

The simplest way to get started is to use旋度orwget, assuming one of these commands is pre-installed. If they are not pre-installed, you can first install them, before proceeding as follows:

  1. Connect to the Linux host:

    ssh @
  2. Download the Docker quick & easy install script

    using旋度:

    旋度-fsSL https://get.docker.com -o get-docker.sh

    orwget:

    wget -O get-docker.sh https://get.docker.com/

You are now ready toinstall Docker.

Alternative method: use scp to transfer the script

If you do not yet have旋度orwgetavailable on the Linux host, and you don't know how to install them, here is an alternative method for downloading and transferring the script to the host. In general, the method described above is preferred.

  1. Download theDocker quick & easy install scriptto any other computer.

  2. Rename the script toget-docker.sh

  3. Copy the script to the Linux host usingscpor any analogous tool:

    scp get-docker.sh @:

    Note the all-important colon (:) at the end of this command. The file is saved on the Linux host in/home/.

  4. Connect to the Linux host:

    ssh @

You are now ready toinstall Docker.

Install Docker

At this point, you are connected to the Linux host, and the quick & easy install scriptget-docker.shis in the current working directory. If you typels get-docker.sh, it should be listed.

When you run the script, it will take the following actions:

  • It downloads and installs the software prerequisites for running Docker on Linux, using the tools that are native to your Linux host. If that software is already installed, there will be no change.
  • It creates a reference to the Docker Linux repositories in the configuration files, so that you can download (and later update) the Docker software directly.
  • It downloads and installs Docker, using the tools that are native to your Linux host.

To install Docker, you must runget-docker.shasrootuser. If you did not log in asroot, you must first becomeroot. To becomeroot, type one of the following commands:

  • Ifsudois installed ( password):sudo su

  • Ifsudois not installed or the user is not in thesudogroup (rootpassword):su

Asrootuser, continue as follows:

  1. Start the installation process:

    sh get-docker.sh

    Hint: You can simulate installation with the commandsh get-docker.sh --dry-run

  2. (可选),当安装完成后,哟u can test docker:

    docker run hello-world
  3. Installdocker-compose, afterchecking the version number:

    旋度-L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose chmod +x /usr/local/bin/docker-compose
  4. (optional) Incorporatebash completion:

    旋度-L https://raw.githubusercontent.com/docker/compose/1.29.2/contrib/completion/bash/docker-compose -o /etc/bash_completion.d/docker-compose
  5. (optional) Testdocker-compose:

    docker-compose --version
  6. (recommended) If you plan to rundocker-composeas a non-root user, make that user a member of thedockergroup:

    usermod -aG docker 

    To register group membership in thedockergroup, the user has to log out and log back in.

Docker is now installed.

更详细的安装文档可以found on theDocker website, for a variety of Linux distributions.

Read more:Deploy RapidMiner AI Hub using pre-configured deployment templates