Quickstart Guide with Docker

Prerequistes

• Docker 20.10.X and up
  • If using MacOS or Windows, install Docker Desktop
• Resources for MacOS/Windows Docker Desktop
  • Docker Desktop → Preferences → Resources → Advanced
    • 2 CPUs
    • 8 GB Memory
• A valid Aspire account and Aspire 5 License (see Aspire Registration and Licensing)
• Download and unzip aspire-quickstart.zip (Needs to update)

4 Steps Installation Process

1. Login to artifactory docker registry:

   
   

   $ docker login docker.repository.sca.accenture.com

   You will be prompted for your credentials (registered email and password)

2. if MacOS or Windows:
   1. Add unzipped aspire-quickstart folder to Docker Desktop sharing paths (Docker Desktop → Preferences → Resources → File Sharing)
3. Copy your AspireLicense.lic to aspire-quickstart/config/
4. Execute installation script:
   1. install-quickstart.sh if MacOS or Linux
   2. install-quickstart.bat if Windows

Now you should be able to access aspire at: https://localhost:50443/

Login with admin1 / 123456abC

Happy crawling with Aspire5!

Uninstall quickstart containers

1. Execute uninstall-quickstart.sh if MacOS or Linux
   
   1. uninstall-quickstart.bat if Windows

What have been installed with these scripts?

The current quickstart guide installs the following containers:

• Elasticsearch / Kibana
  • Elasticsearch
    
    • With Basic Authentication enabled
    • http://localhost:9200/
  • Kibana
    • https://localhost:5601/
• OpenLDAP
  • For Aspire to authenticate users
  • ldap://localhost:20389
• Aspire5 (With HTTPS and authentication enabled)
  • Manager
    • Coordinates job execution
    • https://localhost:50443/
  • Worker
    • Executes job scanning, fetching, processing and publication
    • https://localhost:51443/

Want to know more about the quickstart?

The current quickstart scripts execute the following steps in order:

1. Creates docker volumes for persistent storage (elasticsearch indexes, ssl certificates, ldap directory) and network for all the containers to communicate to each other
2. Generates self-signed certificates and CA for elasticsearch, kibana and aspire nodes (see generate-ssl.[sh/bat])
   1. Copies the certificates to the docker volumes previously created
   2. If you want to do this for an on-premise installation follow Enable HTTPS
3. Starts elasticsearch and kibana
   1. The elasticsearch/docker-compose.yml contains a service that runs once to upload the Kibana Dashboard at elasticsearch/export.ndjson
   2. Uses the certificate docker volumes to obtain and configure the certificates
4. Uploading of settings and AspireLicense to elasticsearch (see update-settings-license.[sh/bat]
   1. Uses the same aspire docker image to do it, the same env properties are provided for the elasticsearch authentication and SSL certificate trusting.
5. Starts the LDAP service
   1. Copies the ldif folder with pre-loaded configuration into the ldap directory docker volume
   2. Starts the ldap/docker-compose.yml
6. Starts aspire service using aspire/docker-compose.yml

All docker containers share the same environment variables at the .env file, this is not recommended for production deployments, but simplifies the management of variables for the quickstart scripts.