Docker: ElectricFlow Community Edition getting started

Run ElectricFlow Community Edition in a Docker container and get your server up and running in minutes.   The Community Edition container runs all components of the ElectricFlow architecture in one container, making it simple to get started.

Follow the steps below to pull and start the ElectricFlow Docker appliance.

 The ElecitricFlow Container requires 6GB of Memory, make sure you have at least 6 GB of memory allocated to Docker by opening your Docker preferences, opening 'Advanced' and adjust memory dedicated to Docker to at least 6 GB.

Prerequisite: Install Docker

Before getting started, first make sure you have Docker installed on your system. Visit https://www.docker.com/ and follow the instructions to install Docker on your platform.

Step 1: Run the ElectricFlow container appliance with Docker

If running using Docker Toolbox on Windows, see the end of the document for additional instructions for starting and accessing the container. 

Run the following docker command to download and start the ElectricFlow container: 

$ docker run --name efserver --hostname=efserver -d -m 6g --memory-swap 4g -p 8080:8080 -p 9990:9990 -p 7800:7800 -p 7070:80 -p 443:443 -p 8443:8443 -p 8200:8200 -i -t ecdocker/eflow-ce

This will pull the ElectricFlow container image from Electric Cloud’s Docker Hub registry, and then start the container named ‘efserver’ in detached mode with the appropriate port mappings.

NOTE: The container should be allocated minimum of 6 GB RAM and 2 CPUs to support the ElectricFlow server.If this is the first time you are running this command, it will take a few minutes to first pull and extract the Docker container image. 

 

Step 2: Create your admin account

 Wait for the container to start completely, this may take a few minutes. Once the container is up, open a browser and go to http://localhost:7070/register to create your admin account for the appliance.

Enter your email address and password that will be used as your admin account to login to the appliance and click Next

The ElectricFlow UI should open automatically after you register.

If it doesn’t, go to http://localhost:7070/flow to get started with ElectricFlow

Step 3: Get Started in Electric Flow

Visit http://localhost:7070/flow to open the ElectricFlow UI and login with the admin account details you entered in step 2.

Get started quickly by completing the in product tutorials that give you step by step guidance through creating your first application and pipeline:

Visit learn.electric-cloud.com/flow/start to learn more.

Connect to the Container

If you need to connect to the container, the credentials are:

Username: ecloud

Password: ecloud

You can execute commands on the container using docker exec, and the ecloud user:

$ docker exec -it --user ecloud efserver /bin/bash

Running on Docker Toolbox for Windows

Docker Toolbox for Windows will create a VM with 1 GB RAM and 1 CPU be default. The ElectricFlow server requires a minimum of 6 GB RAM and 2 CPUs. Before issuing the “docker run” command, increase the size of your VM by:

  1. Stopping the VM

$ docker-machine stop default

  1. Increase the default values to 6 GB RAM and 2 CPUs

  1. Start the VM

$ docker-machine start default

  1. Run docker run to start the container as show in in Step 1

 

To create your account and access ElectricFlow, you must connect to the VM running the container instead of localhost. Run the command below to and get the IP Address from the DOCKER_HOST field:

$ docker-machine env

Replace <CONTAINER_IP> with your IP address, and open:

To Register:http://<CONTAINER_IP>:7070/register

To Access ElectricFlow: http://<CONTAINER_IP>:7070/flow

Have more questions? Submit a request

Comments

Powered by Zendesk