From d332e29c141bbe63975cbf2b24ffd022bf9fb042 Mon Sep 17 00:00:00 2001 From: Casey Bisson Date: Fri, 19 May 2017 13:14:14 -0700 Subject: [PATCH 1/5] Update instructions for new home --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index caa1268..60122be 100644 --- a/README.md +++ b/README.md @@ -5,5 +5,5 @@ Docker CLI helper for Triton ### Installation ```bash -curl -o /usr/local/bin/triton-docker https://raw.githubusercontent.com/misterbisson/triton-docker/working/triton-docker && chmod +x /usr/local/bin/triton-docker && ln -Fs /usr/local/bin/triton-docker /usr/local/bin/triton-compose && ln -Fs /usr/local/bin/triton-docker /usr/local/bin/triton-docker-install +curl -o /usr/local/bin/triton-docker https://raw.githubusercontent.com/joyent/triton-docker-cli/master/triton-docker && chmod +x /usr/local/bin/triton-docker && ln -Fs /usr/local/bin/triton-docker /usr/local/bin/triton-compose && ln -Fs /usr/local/bin/triton-docker /usr/local/bin/triton-docker-install ``` From ea612b070968fe4a2d8abc352367d16dc846b0d7 Mon Sep 17 00:00:00 2001 From: Casey Bisson Date: Fri, 19 May 2017 14:58:00 -0700 Subject: [PATCH 2/5] Add more detailed installation and usage instructions --- README.md | 31 +++++++++++++++++++++++++++++-- 1 file changed, 29 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 60122be..72606a9 100644 --- a/README.md +++ b/README.md @@ -1,9 +1,36 @@ -# triton-docker +# Triton Docker CLI helper -Docker CLI helper for Triton +This script installs known-good, tested versions of the Docker (now Moby) and Docker Compose CLI tools for use with Triton. + +Additionally, this script will automatically configure those tools for use with Triton when you use them, making it easy to switch between Docker on your laptop and Docker on Triton. + +### Compatibility and requirements + +This is designed and tested for Linux and MacOS X. + +This code also requires [the Triton CLI tools](https://docs.joyent.com/public-cloud/api-access/cloudapi) and [a Triton account](https://docs.joyent.com/public-cloud/getting-started) on either the Triton Public Cloud (Joyent public cloud) or in a private cloud powered by Triton. + +Use of this software also requires [a Triton profile configured in the Triton CLI tool](https://docs.joyent.com/public-cloud/api-access/cloudapi#configuration). ### Installation +In a terminal window, run the following command: + ```bash curl -o /usr/local/bin/triton-docker https://raw.githubusercontent.com/joyent/triton-docker-cli/master/triton-docker && chmod +x /usr/local/bin/triton-docker && ln -Fs /usr/local/bin/triton-docker /usr/local/bin/triton-compose && ln -Fs /usr/local/bin/triton-docker /usr/local/bin/triton-docker-install ``` + +That command will copy the `triton-docker` shell script from this repo, and link it as `triton-compose` and `triton-docker-install`. + +To complete the installation, run `sudo triton-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 `triton-docker` and `triton-compose` in place of + +### Components + +In addition to the shell script in this repo, this script will install: + +- [Docker (now Moby) 1.12.6](https://github.com/moby/moby/releases/tag/v1.12.6) +- [Docker Compose 1.9.0](https://github.com/docker/compose/releases/tag/1.9.0) From 58caf431eb733ea254cb86a852065d3171a81b95 Mon Sep 17 00:00:00 2001 From: Casey Bisson Date: Fri, 19 May 2017 14:59:01 -0700 Subject: [PATCH 3/5] Add sudo --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 72606a9..60add50 100644 --- a/README.md +++ b/README.md @@ -17,7 +17,7 @@ Use of this software also requires [a Triton profile configured in the Triton CL In a terminal window, run the following command: ```bash -curl -o /usr/local/bin/triton-docker https://raw.githubusercontent.com/joyent/triton-docker-cli/master/triton-docker && chmod +x /usr/local/bin/triton-docker && ln -Fs /usr/local/bin/triton-docker /usr/local/bin/triton-compose && ln -Fs /usr/local/bin/triton-docker /usr/local/bin/triton-docker-install +sudo curl -o /usr/local/bin/triton-docker https://raw.githubusercontent.com/joyent/triton-docker-cli/master/triton-docker && chmod +x /usr/local/bin/triton-docker && ln -Fs /usr/local/bin/triton-docker /usr/local/bin/triton-compose && ln -Fs /usr/local/bin/triton-docker /usr/local/bin/triton-docker-install ``` That command will copy the `triton-docker` shell script from this repo, and link it as `triton-compose` and `triton-docker-install`. From aadefab045fc1ab1fa625dec00e2a1e8c7a19a12 Mon Sep 17 00:00:00 2001 From: Casey Bisson Date: Fri, 19 May 2017 15:19:57 -0700 Subject: [PATCH 4/5] add usage examples --- README.md | 32 +++++++++++++++++++++++++++++++- 1 file changed, 31 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 60add50..360aa5f 100644 --- a/README.md +++ b/README.md @@ -26,7 +26,37 @@ To complete the installation, run `sudo triton-docker-install` to install the pl ### Usage -Once installed, use `triton-docker` and `triton-compose` in place of +Once installed, use `triton-docker` and `triton-compose` in place of `docker` and `docker-compose` when interacting with the Triton Elastic Docker Host. + +Start a Docker container running Nginx container on Triton: + +```bash +$ triton-docker run -d -p 80 --name webserver nginx +Executing in 'us-sw-1' (default; use `triton profile set ` to change) at 03:11:11 PM +d5cae48b0072610ecc67f6aecb3115f9fadff59b2151694a963084dad40e5d85 +$ +``` + +Start [all the containers to run WordPress](https://github.com/autopilotpattern/wordpress) via Docker Compose on Triton: + +```bash +$ triton-compose up -d +Executing in 'us-sw-1' (default; use `triton profile set ` 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: + +- [Docker commands on Triton](https://www.joyent.com/blog/docker-commands-on-triton) +- [Docker Compose on Triton](https://www.joyent.com/blog/using-docker-compose) +- [Optimizing your Docker operations for Triton](https://www.joyent.com/blog/optimizing-docker-on-triton) ### Components From bd633ff7ce54b6fec07c272ea4b1a322cd0e0f4b Mon Sep 17 00:00:00 2001 From: Casey Bisson Date: Mon, 22 May 2017 08:15:53 -0700 Subject: [PATCH 5/5] Update README.md --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 360aa5f..c8216ca 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@ # Triton Docker CLI helper -This script installs known-good, tested versions of the Docker (now Moby) and Docker Compose CLI tools for use with Triton. +This script installs known good, tested versions of the Docker (now Moby) and Docker Compose CLI tools for use with Triton. Additionally, this script will automatically configure those tools for use with Triton when you use them, making it easy to switch between Docker on your laptop and Docker on Triton. @@ -8,7 +8,7 @@ Additionally, this script will automatically configure those tools for use with This is designed and tested for Linux and MacOS X. -This code also requires [the Triton CLI tools](https://docs.joyent.com/public-cloud/api-access/cloudapi) and [a Triton account](https://docs.joyent.com/public-cloud/getting-started) on either the Triton Public Cloud (Joyent public cloud) or in a private cloud powered by Triton. +This code also requires [the Triton CLI tools](https://docs.joyent.com/public-cloud/api-access/cloudapi) and [a Triton account](https://docs.joyent.com/public-cloud/getting-started) on either Triton public cloud (Joyent public cloud) or in a private cloud powered by Triton. Use of this software also requires [a Triton profile configured in the Triton CLI tool](https://docs.joyent.com/public-cloud/api-access/cloudapi#configuration).