eShopOnContainers/README.dcos.md

eShopOnContainers on DC/OS

Prerequisites

• A DC/OS cluster. Follow Azure Container Service's walkthrough to create one.
• A private Docker registry. Follow Azure Container Registry's guide to create one.
• The dcos CLI. See DC/OS: Installing the CLI for more details.

Prepare the Cluster

1. Install Marathon-LB to your cluster. This can be done with the DC/OS cli (dcos package install marathon-lb) or web interface. See the DC/OS docs for more information.
2. Provide Marathon credentials for your container registry.
   • Mount an Azure file share on each agent of the cluster at /mnt/share. See the Azure Container Service documentation for guidance.
   • Copy your private registry credentials to the mounted share as described in the Azure Container Service documentation.

Deploy the Application

1. Build the eShopOnContainers Docker images.
2. Open a PowerShell window in your local eShopOnContainers repository's dcos directory.
3. Tag the eshop/... images with your registry, then push them.
   • tagpush.ps1 can do this for you, e.g.:

   ./tagpush.ps1 myregistry.azurecr.io
   

4. Open an SSH tunnel to your cluster as described in the ACS documentation: Connect with an ACS cluster
5. Ensure dcos is on your path.
6. Run generate-config.ps1 to generate configuration for the eShopOnContainers services. The script requires hostnames for your cluster's agents and your private registry. Your agents' hostname is of the form [dns prefix]agents.[Azure region].cloudapp.azure.com:

./generate-config.ps1 -agentsFqdn mydcosagents.centralus.cloudapp.azure.com -registry myregistry.azurecr.io

7. Use the dcos CLI to deploy the application:

dcos marathon group add eShopOnContainers.json

You can watch the deployment progress in the DC/OS web interface at http://localhost/#/services/.