diff --git a/install-sandbox.md b/install-sandbox.md index dd5a4d735f..2ee28ed172 100644 --- a/install-sandbox.md +++ b/install-sandbox.md @@ -87,7 +87,7 @@ Set up the nodes for your evaluation: ``` $ docker-machine create -d virtualbox \ --virtualbox-memory "2000" \ - --virtualbox-disk-size "5000" node1 \ + --virtualbox-disk-size "5000" node1 ``` When you create your virtual host you specify the memory and disk size @@ -196,7 +196,7 @@ host for the controller works fine. supplied to replace it with the actual IP address. The first time you run the `ucp` tool, the `docker run` command pulls the - UCP bootstrapper image from Docker Hub. The tool downloads the packages it + UCP bootstrapper image from Docker Cloud. The tool downloads the packages it needs, and verifies that your system will support a UCP installation. 4. Enter a password for UCP when prompted, and then confirm it. @@ -214,8 +214,8 @@ host for the controller works fine. individual "leaf certificates." When it completes, the `ucp` tool prompts you to log in into the UCP web - interface when it completes, and gives you its location. You'll do this so - you can install a license in the next step. + interface and gives you its location. You'll do this in the next stepo so + you can install a license. ## Step 3. License your installation @@ -395,23 +395,6 @@ Now that you have your DTR instance up and running, we'll link it to your UCP in * [Install UCP for production](installation/install-production.md). - 4. Navigate to where the bundle was downloaded, and unzip the client bundle @@ -82,9 +278,12 @@ Download the bundle and configure your environment. extracting: env.sh ``` -5. Change into the directory that was created when the bundle was unzipped +5. From your shell, change into the directory created when the bundle was +unzipped. -6. Execute the `env.sh` script to set the appropriate environment variables for your UCP deployment. +6. Execute the `env.sh` script. + + This sets the appropriate environment variables for your UCP deployment. ``` $ source env.sh @@ -94,60 +293,10 @@ Download the bundle and configure your environment. 7. Run `docker info` to examine the UCP deployment. - Your output should show that you are managing UCP vs. a single node. + Your output should reflect a connection to UCP, instead of just a single local Docker instance. If you completed the previous installation tutorial, you should see `Nodes: 2` in the output. ```none $ docker info - Containers: 12 - Running: 0 - Paused: 0 - Stopped: 0 - Images: 17 - Role: primary - Strategy: spread - Filters: health, port, dependency, affinity, constraint - Nodes: 2 - node1: 192.168.99.106:12376 - └ Status: Healthy - └ Containers: 9 - └ Reserved CPUs: 0 / 1 - └ Reserved Memory: 0 B / 3.01 GiB - └ Labels: executiondriver=native-0.2, kernelversion=4.1.17-boot2docker, operatingsystem=Boot2Docker 1.10.0 (TCL 6.4.1); master : b09ed60 - Thu Feb 4 20:16:08 UTC 2016, provider=virtualbox, storagedriver=aufs - └ Error: (none) - └ UpdatedAt: 2016-02-09T12:03:16Z - node2: 192.168.99.107:12376 - └ Status: Healthy - └ Containers: 3 - └ Reserved CPUs: 0 / 1 - └ Reserved Memory: 0 B / 4.956 GiB - └ Labels: executiondriver=native-0.2, kernelversion=4.1.17-boot2docker, operatingsystem=Boot2Docker 1.10.0 (TCL 6.4.1); master : b09ed60 - Thu Feb 4 20:16:08 UTC 2016, provider=virtualbox, storagedriver=aufs - └ Error: (none) - └ UpdatedAt: 2016-02-09T12:03:11Z - Cluster Managers: 1 - 192.168.99.106: Healthy - └ Orca Controller: https://192.168.99.106:443 - └ Swarm Manager: tcp://192.168.99.106:3376 - └ KV: etcd://192.168.99.106:12379 - Plugins: - Volume: - Network: - CPUs: 2 - Total Memory: 7.966 GiB - Name: ucp-controller-node1 - ID: P5QI:ZFCX:ELZ6:RX2F:ADCT:SJ7X:LAMQ:AA4L:ZWGR:IA5V:CXDE:FTT2 - WARNING: No oom kill disable support - WARNING: No cpu cfs quota support - WARNING: No cpu cfs period support - WARNING: No cpu shares support - WARNING: No cpuset support - Labels: - com.docker.ucp.license_key=p3vPAznHhbitGG_KM36NvCWDiDDEU7aP_Y9z4i7V4DNb - com.docker.ucp.license_max_engines=1 - com.docker.ucp.license_expires=2016-11-11 00:53:53 +0000 UTC - ``` - - ``` - $ docker info Containers: 18 Images: 28 Server Version: swarm/1.2.5 @@ -188,107 +337,26 @@ Download the bundle and configure your environment. com.docker.ucp.license_key=cbikfA44-5gAJ3iOgPp_6AMl_V_uRxFiITvyVvESdFWx com.docker.ucp.license_max_engines=10 com.docker.ucp.license_expires=2016-10-29 00:01:45 +0000 UTC - ``` - - -## Step 8. Deploy a container -UCP allows you to deploy and manage "Dockerized" applications in production. An -application is built using Docker objects, such as images and containers, and -Docker resources, such as volumes and networks. +## Docker pull to put images on ucp -UCP deploys and manages these objects and resources using remote API calls to -the Engine daemons running on the nodes. For example, the `run` action may -deploy an image in a Docker container. That image might define a service such as -an Nginx web server or a database like Postgres. +1. docker pull nginx - from docker hub/cloud +``` +$ docker pull nginx +Using default tag: latest +node1: Pulling nginx:latest... : downloaded +node2: Pulling nginx:latest... : downloaded +``` + see that it shows up on both nodes -A UCP administrator initiates Engine actions using the UCP dashboard or the -Docker Engine CLI. In this step, you deploy a container from the UCP dashboard. -The container runs an Nginx server, so you'll need to launch the `nginx` image -inside of it. -1. Log in to the UCP **Dashboard**. -2. Click **Containers**. - - The system displays the **Containers** page. - - > **Tip**: UCP runs some containers that support its own operations called - "system" containers. These containers are hidden by default. - -3. Click **+ Deploy Container**. - - UCP provides a dialog for you to enter configuration options for the container. For this example, we'll deploy a simple `nginx` container using specific values for each field. If you already know what you're doing, feel free to explore once you've completed this example. - -4. Enter `nginx` for the image name. - - An image is a specific build of software you want to run. The software might - be a stand-alone application, or component software necessary to support a - complex service. - -5. Enter `nginx_server` for the container name. - - This name just identifies the container on your network. - -6. Click **Publish Ports** from the **Overview** menu. - - A Docker container is isolated from other processes on your network and has its own internal network configuration. To access the service inside a container, you need to expose the container's port, which maps to a port on the node. The node is hosting an instance of Docker Engine, so its port is called the **Host Port**. - -7. Enter `443` in both the **Port** field and the **Host Port** field. - -8. Click the plus sign to add another **Port**. - -9. For this port, enter `80` in both the **Port** and **Host Port** fields. - - When you are done, your dialog should look like this: - - ![Port configuration](images/port_config.png) - -10. Click **Run Container** to deploy the container. - - ![Deployed](images/display_container.png) - -## Step 9. View a running service - -At this point, you have deployed a container and you should see the container -status is `running`. Recall that you deployed an Nginx web server. That server -comes with a default page that you can view to validate that the server is -running. In this step, you open the running server. - -1. Navigate back to the **Containers** page. - -2. Click the edit icon on the container. - - ![Edit](images/container_edit.png) - - The system displays the container's details and some operations you can run on the container. - -3. Scroll down to the ports section. - - You'll see an IP address with port `80` for the server. - -4. Copy the IP address to your browser and paste the information you copied. - - You should see the welcome message for nginx. - - ![Port 80](images/welcome_nginx.png) ## Step 11. Deploy with the CLI