Unverified Commit a135989d authored by watucker's avatar watucker Committed by GitHub
Browse files

Merge pull request #191 from ESGF/ansible-fixes-as 

Fixed pip version in docker ansible role and updated docs
parents 64a6ad6f f4f47d78

deploy/ansible/host_vars/esgf.data.example.org

+6 −2
Original line number Diff line number Diff line 
### EDIT THIS



### Example of a host_vars file specific to the host "esgf.data.example.org".



### Provides variables for only this host machine.



### See: https://github.com/ESGF/esgf-docker/blob/master/docs/deploy-ansible.md

### For more information about configuring an Ansible installation.



### for more information about configuring an Ansible installation.







## OPTIONAL: Enabling and disabling components:



#thredds_enabled: true/false



#fileserver_enabled: true/false



# https://github.com/ESGF/esgf-docker/blob/master/docs/deploy-ansible.md#enabling-and-disabling-components
 
### See: https://github.com/ESGF/esgf-docker/blob/master/docs/deploy-ansible.md#enabling-and-disabling-components

deploy/ansible/host_vars/esgf.index.example.org

+6 −2
Original line number Diff line number Diff line 
### EDIT THIS



### Example of a host_vars file specific to the host "esgf.index.example.org".



### Provides variables for only this host machine.



### See: https://github.com/ESGF/esgf-docker/blob/master/docs/deploy-ansible.md

### For more information about configuring an Ansible installation.



### for more information about configuring an Ansible installation.







## OPTIONAL: Enabling and disabling components:



#solr_enabled: true/false



#search_enabled: true/false



# https://github.com/ESGF/esgf-docker/blob/master/docs/deploy-ansible.md#enabling-and-disabling-components
 
### See: https://github.com/ESGF/esgf-docker/blob/master/docs/deploy-ansible.md#enabling-and-disabling-components

deploy/ansible/roles/docker/tasks/main.yml

+5 −0
Original line number Diff line number Diff line
@@ -46,6 +46,11 @@ 
    name: python-pip

    state: latest



- name: Update pip to more recent version (but not py3 latest)

  pip:

    name: pip

    version: 19.0



- name: Install Docker SDK

  pip:

    name: docker

docs/deploy-ansible.md

+15 −0
Original line number Diff line number Diff line
@@ -24,6 +24,7 @@ configurations. 
    - [Configuring Solr replicas](#configuring-solr-replicas)

    - [Using external Solr instances](#using-external-solr-instances)

    - [Fowarding access logs](#fowarding-access-logs)

- [Testing the service endpoints](#testing-service-endpoints)



<!-- /TOC -->
@@ -83,6 +84,9 @@ vagrant up 


After waiting for the containers to start, the THREDDS interface will be available at http://192.168.100.100.nip.io/thredds.



**NOTE:** The Vagrant installation is known to have problems when run from a Windows host. We do not recommend

installing from Windows.



## Configuring the installation



This section describes the most commonly modified configuration options. For a full list of available
@@ -310,3 +314,14 @@ logstash_enabled: true 
Additional variables are available to configure the server to which logs should be forwarded -

please see the [role defaults for the data role](../deploy/ansible/roles/data/defaults/main.yml) -

however the vast majority of deployments will not need to change these.



## Testing the service endpoints



Once the playbook has successfully then you should see a THREDDS catalog webpage at this URL:



 `http://<data:host_name>/thredds`



And the following should return a JSON response:



 `http://<index:host_name>/esg-search/search?fields=*&type=File&latest=true&format=application%2Fsolr%2Bjson&limit=10&offset=0`