ayan.poddar
/
eShopOnContainers
1
0
Fork 0
Code Issues 0 Pull Requests 0 Projects 0 Releases 19 Wiki Activity
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
769 Commits
36 Branches
655 MiB
Tree: 25f23d2503
Branches Tags
${ item.name }
Create branch ${ searchTerm }
from '25f23d2503'
${ noResults }
eShopOnContainers/README.k8s.md

19 lines
2.5 KiB
Raw Normal View History

update READMEs
7 years ago
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
 
  1. # eShopOnContainers on Kubernetes

  2. The k8s directory contains Kubernetes configuration for the eShopOnContainers app and a PowerShell script to deploy it to a cluster. Each eShopOnContainers microservice has a deployment configuration in `deployments.yaml`, and is exposed to the cluster by a service in `services.yaml`. The microservices are exposed externally on individual routes (`/basket-api`, `/webmvc`, etc.) by an nginx reverse proxy specified in `frontend.yaml` and `nginx.conf`.
  3. 

  4. ## Prerequisites

  5. * A Kubernetes cluster. Follow Azure Container Service's [walkthrough](https://docs.microsoft.com/en-us/azure/container-service/container-service-kubernetes-walkthrough) to create one.
  6. * A private Docker registry. Follow Azure Container Registry's [guide](https://docs.microsoft.com/en-us/azure/container-registry/container-registry-get-started-portal) to create one.
  7. * A Docker development environment with `docker` and `docker-compose`.
  8.     * Visit [docker.com](https://docker.com) to download the tools and set up the environment. Docker's [installation guide](https://docs.docker.com/engine/getstarted/step_one/#step-3-verify-your-installation) covers verifying your Docker installation.
  9. *  The Kubernetes command line client, `kubectl`.
  10.     * This can be installed with the `az` tool as described in the Azure Container Service [walkthrough](https://docs.microsoft.com/en-us/azure/container-service/container-service-kubernetes-walkthrough). `az` is also helpful for getting the credentials `kubectl` needs to access your cluster. For other installation options, and information about configuring `kubectl` yourself, see the [Kubernetes documentation](https://kubernetes.io/docs/tasks/kubectl/install/).
  11. 

  12. ## Deploy the application with the deployment script

  13. 1. Open a PowerShell command line at the `k8s` directory of your local eShopOnContainers repository.
  14. 1. Ensure `docker`, `docker-compose`, and `kubectl` are on the path, and configured for your Docker machine and Kubernetes cluster.
  15. 1. Run `deploy.ps1` with your registry information. The Docker username and password are provided by Azure Container Registry, and can be retrieved from the Azure portal. For example:
  16. >```
  17. >./deploy.ps1 -registry myregistry.azurecr.io -dockerUser User -dockerPassword SecretPassword
  18. >```
  19. The script will build the code and corresponding Docker images, push the latter to your registry, and deploy the application to your cluster. You can watch the deployment unfold from the Kubernetes web interface: run `kubectl proxy` and open a browser to [http://localhost:8001/ui](http://localhost:8001/ui)