LICENSE | ||
README.md | ||
spearhead-docker |
Spearhead Docker CLI helper
This script will install compatible Docker versions for use with the Spearhead Cloud.
Your existing Docker will not be affected and you can conveniently switch between your own Docker and the Spearhead Cloud docker tools.
Compatibility and requirements
This is designed and tested for Linux and MacOS X.
This code requires Spearhead Cloud CLI tool and a Spearhead Cloud account.
Installation
In a terminal window, run the following command:
sudo bash -c 'curl -o /usr/local/bin/spearhead-docker https://code.spearhead.cloud/Spearhead/spearhead-docker-cli/raw/branch/master/spearhead-docker && chmod +x /usr/local/bin/spearhead-docker && ln -Fs /usr/local/bin/spearhead-docker /usr/local/bin/spearhead-compose && ln -Fs /usr/local/bin/spearhead-docker /usr/local/bin/spearheadn-docker-install'
That command will copy the spearhead-docker
shell script from this repo, and link it as spearhead-compose
and spearhead-docker-install
.
To complete the installation, run sudo spearhead-docker-install
to install the platform-specific versions of the Docker (now Moby) and Docker Compose CLI tools. These versions will not replace any existing Docker or Docker Compose versions you may have installed.
Usage
Once installed, use spearhead-docker
and spearhead-compose
in place of docker
and docker-compose
when interacting with the Spearhead Cloud.
Start a Docker container running Nginx container on Spearhead Cloud:
$ spearhead-docker run -d -p 80 --name webserver nginx
Executing in 'ro-1' (default; use `spearhead profile set <profile name>` to change) at 05:02:41 AM
x5gso83h9365831psn43h7qwuc3115f9fitff59b2151694a963043sue94k2f73
$
Start all the containers to run WordPress via Docker Compose on Spearhead Cloud:
$ spearhead-compose up -d
Executing in 'ro-1' (default; use `spearhead profile set <profile name>` to change) at 03:15:56 PM
Creating wp_wordpress_1
Creating wp_nginx_1
Creating wp_nfs_1
Creating wp_memcached_1
Creating wp_prometheus_1
Creating wp_mysql_1
Creating wp_consul_1
$
More about:
Triton Container Name Service helpers
This will also set some helpful environment variables for using Triton Container Name Service (CNS):
SC_CNS_SEARCH_DOMAIN_PUBLIC
SC_CNS_SEARCH_DOMAIN_PRIVATE
Those vars will be automatically set with values appropriate for use in Spearhead Public Cloud:
SC_CNS_SEARCH_DOMAIN_PRIVATE=a42e7881-89d2-459e-bc0b-e9af0bca409a.us-east-3.cns.spearhead.cloud
SC_CNS_SEARCH_DOMAIN_PUBLIC=a42e7881-89d2-459e-bc0b-e9af0bca409a.us-east-3.spearhead.cloud
Components
In addition to the shell script in this repo, this script will install: