Commit 185d0e16 authored by Luca Cinquini's avatar Luca Cinquini
Browse files

Updating documentation for single host deployment

parent 17757ca1
Loading
Loading
Loading
Loading
+1 −1
Original line number Diff line number Diff line
# Sphinx build info version 1
# This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
config: 4d3597b4651c71301cf359fad5392948
config: 5181bd2b8280e663a350317fc93a53af
tags: 645f666f9bcd5a90fca523b33c5a78b7
+3 −3
Original line number Diff line number Diff line
.. _docker_swarm_setup_on_linux:

**************************
Docker Swam Setup on Linux
**************************
***************************
Docker Swarm Setup on Linux
***************************

Abstract
========
+3 −3
Original line number Diff line number Diff line
.. _docker_swarm_setup_on_macosx:

***************************
Docker Swam Setup on MacOSX
***************************
****************************
Docker Swarm Setup on MacOSX
****************************

Abstract
========
+30 −3
Original line number Diff line number Diff line
@@ -14,10 +14,33 @@ Version

*  Docker version 17.09.0-ce, build afdb6d4

Docker container managment
==========================

List the running containers::

  docker ps

List all the containers (including the stopped ones)::

  docker ps -a

Remove all the container (running or not)::

  docker ps -aq | xargs docker rm --force
  
Inspect/connect to a running container (ex: 67e4c31da0ee)::

  # Get the container ID from the docker ps command.
  docker exec -it 67e4c31da0ee bash

Docker volume managment
=======================

List the volumes::

  docker volume ls

Remove dangling volumes of container::

  docker volume ls -f "dangling=true" | xargs docker volume rm 
@@ -30,6 +53,10 @@ Remove all volumes::
Docker image managment
======================

List the images::

  docker image ls # or docker images

Remove dangling images::

  docker image ls -f "dangling=true" | xargs docker image rm 
@@ -38,14 +65,14 @@ Remove all volumes::

  docker image ls -q | xargs docker image rm --force

Remove image according to a given pattern (e.g. the esgfhub devel images)::
Remove image according to a given pattern (ex: the esgfhub devel images)::

  docker images "esgfhub/*:devel" -q | xargs docker image rm

Remove imges tagged "<none>"::
Remove images tagged "<none>"::

  docker image ls | grep "^<none>" | awk '{print $3}' | xargs docker image rm --force

Inspect the contains of an image (esgfhub/esgf-http:devel image)::
Inspect/connect to an image (ex: esgfhub/esgf-http:devel image)::

  docker run --rm -it --entrypoint=/bin/bash esgfhub/esgf-http:devel
 No newline at end of file
+9 −5
Original line number Diff line number Diff line
@@ -15,9 +15,13 @@ appropriate metadata tags are set for that node.
Pre-Requisites
==============

A Docker Swarm composed of 1 or more nodes. See specific instructions on
how to set this up on :ref:`a single MacOSX laptop <docker_swarm_setup_on_macosx>`, on the Amazon Cloud, or an
internal Linux cluster.
*  A host system with the latest version of Docker Engine installed (at
   this time, Docker 1.12+).
*  Java SDK (at this time 1.8), keytool is required (add it to the PATH var env).

*  A Docker Swarm composed of 1 or more nodes. See specific instructions on
   how to set this up on :ref:`a single MacOSX laptop <docker_swarm_setup_on_macosx>`, on 
   the Amazon Cloud, or :ref:`a single Linux machine <docker_swarm_setup_on_linux>`.

Setup
=====
@@ -26,7 +30,7 @@ Follow the same setup steps as for the :ref:`single_host_deployment`, namely:

*  Checkout the source code from this GitHub repository, on some
   location on the Swarm manager node. Use the *master* branch.
*  Define the environmental variables $ESGF_HOSTNAME, $ESGF_CONFIG,
*  Define the environmental variables $PATH (for keytool), $ESGF_HOSTNAME, $ESGF_CONFIG,
   $ESGF_VERSION and $ESGF_DATA_DIR. 
*  Initialize the ESGF node configuration: ./esgf_node_init.sh

@@ -56,7 +60,7 @@ Execution
      docker node update --label-add esgf_data_node=true node3

   Or, on a Swarm of 6 nodes, each label can be assigned to a different node 
   (as shown in the :ref:`single MacOSX laptop instructions <docker_swarm_setup_on_macosx>`).
   (as shown in the :ref:`single MacOSX laptop instructions <docker_swarm_setup_on_macosx>` or :ref:`single Linux laptop instructions <docker_swarm_setup_on_linux>`).

*  From the source code directory on the Swarm manager node, issue the
   following command to deploy the stack of ESGF services, then wait for
Loading