Loading .buildinfo +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: 381e22fae4225e2018cada5b04340b97 config: 4d3597b4651c71301cf359fad5392948 tags: 645f666f9bcd5a90fca523b33c5a78b7 _sources/git_workflow.rst.txt +3 −0 Original line number Diff line number Diff line Loading @@ -65,3 +65,6 @@ Schematic representation of how Git branches are created and tagged when working :scale: 100 % :alt: ESGF versioning diagram Merge ===== _sources/single_host_deployment.rst.txt +3 −2 Original line number Diff line number Diff line Loading @@ -115,11 +115,12 @@ Setup * Initialize your node configuration: create a self-signed certificate for $ESGF_HOSTNAME and populate the $ESGF_CONFIG directory with initial content:: Note: if you are on a Mac, ensure **gtar** and **xz** utilities are installed before running the :code:`esgf_node_init.sh` script:: ./scripts/esgf_node_init.sh ls -l $ESGF_CONFIG Note: if you are on a Mac, ensure **gtar** and **xz** utilities are installed before running the :code:`esgf_node_init.sh` script. Note: it's been observed that the Docker engine on a mac might not track time correctly if the mac goes into sleep mode, which may cause problems with the validity of the certificates. To bypass this issue, restart the Docker engine after generating the certificates. Loading _static/basic.css +0 −7 Original line number Diff line number Diff line Loading @@ -398,13 +398,6 @@ table.field-list td, table.field-list th { margin: 0; } .field-name { -moz-hyphens: manual; -ms-hyphens: manual; -webkit-hyphens: manual; hyphens: manual; } /* -- other body styles ----------------------------------------------------- */ ol.arabic { Loading architecture_and_development_guidelines.html +11 −8 Original line number Diff line number Diff line <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <title>Architecture and Development Guidelines — ESGF-Docker Documentation</title> <link rel="stylesheet" href="_static/nature.css" type="text/css" /> <link rel="stylesheet" href="_static/pygments.css" type="text/css" /> <script type="text/javascript"> var DOCUMENTATION_OPTIONS = { URL_ROOT: './', Loading @@ -26,7 +29,7 @@ <link rel="next" title="Docker Swarm Setup on MacOSX" href="docker_swarm_setup_on_macosx.html" /> <link rel="prev" title="Data Publishing" href="data_publishing.html" /> </head> <body> <body role="document"> <div class="related" role="navigation" aria-label="related navigation"> <h3>Navigation</h3> <ul> Loading Loading @@ -60,14 +63,14 @@ specific images are derived. This design has several benefits:</p> <ul class="simple"> <li>All images run the same version of the core OS, libraries and engines such as Centos, Java, Python, SSL, Tomcat, etc.</li> <li>It’s easy to propagate updates of any of these components to all images.</li> <li>It’s easy to propagate updates of any of these components to all images.</li> <li>Common building instructions are not repeated, in different form, in different Dockerfiles.</li> </ul> <p>The current version of the ESGF image hierarchy is shown in the figure below.</p> </div> <div class="section" id="image-content"> <h2>Image Content<a class="headerlink" href="#image-content" title="Permalink to this headline">¶</a></h2> <p>For maximum flexibility, and conforming to the “micro-services” <p>For maximum flexibility, and conforming to the “micro-services” architecture, each ESGF image should contain only one service, interacting with the other ESGF services through publicly exposed endpoints. In some cases though a set of services must be co-located as Loading Loading @@ -95,7 +98,7 @@ this repository.</p> </div> <div class="section" id="supervisor"> <h2>Supervisor<a class="headerlink" href="#supervisor" title="Permalink to this headline">¶</a></h2> <p>ESGF images should use the Python program “Supervisor” to start and <p>ESGF images should use the Python program “Supervisor” to start and monitor services inside a Docker container. Benefits of using Supervisor include:</p> <ul class="simple"> Loading @@ -104,7 +107,7 @@ service from inside each container.</li> <li>Ability to add services to the startup pool by simply dropping configuration files in a standard location.</li> <li>Ability to start/stop/restart entire group of services (for example, all Solr shards at once).</li> <li>Ability to start services as non-privileged users such as “tomcat”, “apache”, etc.</li> <li>Ability to start services as non-privileged users such as “tomcat”, “apache”, etc.</li> </ul> <p>Supervisor is installed as part of the <em>esgf-node</em> base image, and started by default unless a child image overrides the Docker CMD instruction.</p> Loading @@ -127,7 +130,7 @@ configuration, such as SSL certificates, hostnames, passwords etc. At this time, all site-specific configuration is stored in a directory tree rooted at $ESGF_CONFIG/, which is cross-mounted as a shared volume on on all containers. In the future, the site-specific configuration might be “pushed” to the containers via other means.</p> be “pushed” to the containers via other means.</p> </div> <div class="section" id="persistent-data"> <h2>Persistent Data<a class="headerlink" href="#persistent-data" title="Permalink to this headline">¶</a></h2> Loading Loading @@ -212,7 +215,7 @@ upgrades.</p> </div> <div class="footer" role="contentinfo"> © Copyright 2017, ESGF. Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.6.3. Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.5.6. </div> </body> </html> No newline at end of file Loading
.buildinfo +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: 381e22fae4225e2018cada5b04340b97 config: 4d3597b4651c71301cf359fad5392948 tags: 645f666f9bcd5a90fca523b33c5a78b7
_sources/git_workflow.rst.txt +3 −0 Original line number Diff line number Diff line Loading @@ -65,3 +65,6 @@ Schematic representation of how Git branches are created and tagged when working :scale: 100 % :alt: ESGF versioning diagram Merge =====
_sources/single_host_deployment.rst.txt +3 −2 Original line number Diff line number Diff line Loading @@ -115,11 +115,12 @@ Setup * Initialize your node configuration: create a self-signed certificate for $ESGF_HOSTNAME and populate the $ESGF_CONFIG directory with initial content:: Note: if you are on a Mac, ensure **gtar** and **xz** utilities are installed before running the :code:`esgf_node_init.sh` script:: ./scripts/esgf_node_init.sh ls -l $ESGF_CONFIG Note: if you are on a Mac, ensure **gtar** and **xz** utilities are installed before running the :code:`esgf_node_init.sh` script. Note: it's been observed that the Docker engine on a mac might not track time correctly if the mac goes into sleep mode, which may cause problems with the validity of the certificates. To bypass this issue, restart the Docker engine after generating the certificates. Loading
_static/basic.css +0 −7 Original line number Diff line number Diff line Loading @@ -398,13 +398,6 @@ table.field-list td, table.field-list th { margin: 0; } .field-name { -moz-hyphens: manual; -ms-hyphens: manual; -webkit-hyphens: manual; hyphens: manual; } /* -- other body styles ----------------------------------------------------- */ ol.arabic { Loading
architecture_and_development_guidelines.html +11 −8 Original line number Diff line number Diff line <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <title>Architecture and Development Guidelines — ESGF-Docker Documentation</title> <link rel="stylesheet" href="_static/nature.css" type="text/css" /> <link rel="stylesheet" href="_static/pygments.css" type="text/css" /> <script type="text/javascript"> var DOCUMENTATION_OPTIONS = { URL_ROOT: './', Loading @@ -26,7 +29,7 @@ <link rel="next" title="Docker Swarm Setup on MacOSX" href="docker_swarm_setup_on_macosx.html" /> <link rel="prev" title="Data Publishing" href="data_publishing.html" /> </head> <body> <body role="document"> <div class="related" role="navigation" aria-label="related navigation"> <h3>Navigation</h3> <ul> Loading Loading @@ -60,14 +63,14 @@ specific images are derived. This design has several benefits:</p> <ul class="simple"> <li>All images run the same version of the core OS, libraries and engines such as Centos, Java, Python, SSL, Tomcat, etc.</li> <li>It’s easy to propagate updates of any of these components to all images.</li> <li>It’s easy to propagate updates of any of these components to all images.</li> <li>Common building instructions are not repeated, in different form, in different Dockerfiles.</li> </ul> <p>The current version of the ESGF image hierarchy is shown in the figure below.</p> </div> <div class="section" id="image-content"> <h2>Image Content<a class="headerlink" href="#image-content" title="Permalink to this headline">¶</a></h2> <p>For maximum flexibility, and conforming to the “micro-services” <p>For maximum flexibility, and conforming to the “micro-services” architecture, each ESGF image should contain only one service, interacting with the other ESGF services through publicly exposed endpoints. In some cases though a set of services must be co-located as Loading Loading @@ -95,7 +98,7 @@ this repository.</p> </div> <div class="section" id="supervisor"> <h2>Supervisor<a class="headerlink" href="#supervisor" title="Permalink to this headline">¶</a></h2> <p>ESGF images should use the Python program “Supervisor” to start and <p>ESGF images should use the Python program “Supervisor” to start and monitor services inside a Docker container. Benefits of using Supervisor include:</p> <ul class="simple"> Loading @@ -104,7 +107,7 @@ service from inside each container.</li> <li>Ability to add services to the startup pool by simply dropping configuration files in a standard location.</li> <li>Ability to start/stop/restart entire group of services (for example, all Solr shards at once).</li> <li>Ability to start services as non-privileged users such as “tomcat”, “apache”, etc.</li> <li>Ability to start services as non-privileged users such as “tomcat”, “apache”, etc.</li> </ul> <p>Supervisor is installed as part of the <em>esgf-node</em> base image, and started by default unless a child image overrides the Docker CMD instruction.</p> Loading @@ -127,7 +130,7 @@ configuration, such as SSL certificates, hostnames, passwords etc. At this time, all site-specific configuration is stored in a directory tree rooted at $ESGF_CONFIG/, which is cross-mounted as a shared volume on on all containers. In the future, the site-specific configuration might be “pushed” to the containers via other means.</p> be “pushed” to the containers via other means.</p> </div> <div class="section" id="persistent-data"> <h2>Persistent Data<a class="headerlink" href="#persistent-data" title="Permalink to this headline">¶</a></h2> Loading Loading @@ -212,7 +215,7 @@ upgrades.</p> </div> <div class="footer" role="contentinfo"> © Copyright 2017, ESGF. Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.6.3. Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.5.6. </div> </body> </html> No newline at end of file