mirror of https://github.com/docker/docs.git
Remove Desktop Compose on Kubernetes docs
Signed-off-by: Chris Crone <christopher.crone@docker.com>
This commit is contained in:
parent
fcf6513567
commit
f500ce97a4
|
@ -61,69 +61,6 @@ Kubernetes.
|
||||||
|
|
||||||
{{ kubectl-warning }}
|
{{ kubectl-warning }}
|
||||||
|
|
||||||
## Use Docker commands
|
|
||||||
|
|
||||||
To ensure that the docker stack commands are available on your installation, try
|
|
||||||
`docker stack ls`. If you see the message `failed to find a Stack API version`
|
|
||||||
then the commands described on this page are not available. This can be confirmed
|
|
||||||
with `docker version` which should contain the line `StackAPI: Unknown`.
|
|
||||||
|
|
||||||
If docker stack commands are working then you can deploy a stack on Kubernetes with
|
|
||||||
`docker stack deploy`, the `docker-compose.yml` file, and the name of the stack.
|
|
||||||
|
|
||||||
```bash
|
|
||||||
docker stack deploy --compose-file /path/to/docker-compose.yml mystack
|
|
||||||
docker stack services mystack
|
|
||||||
```
|
|
||||||
|
|
||||||
You can see the service deployed with the `kubectl get services` command.
|
|
||||||
|
|
||||||
### Specify a namespace
|
|
||||||
|
|
||||||
By default, the `default` namespace is used. You can specify a namespace with
|
|
||||||
the `--namespace` flag.
|
|
||||||
|
|
||||||
```bash
|
|
||||||
docker stack deploy --namespace my-app --compose-file /path/to/docker-compose.yml mystack
|
|
||||||
```
|
|
||||||
|
|
||||||
Run `kubectl get services -n my-app` to see only the services deployed in the
|
|
||||||
`my-app` namespace.
|
|
||||||
|
|
||||||
### Override the default orchestrator
|
|
||||||
|
|
||||||
While testing Kubernetes, you may want to deploy some workloads in swarm mode.
|
|
||||||
Use the `DOCKER_STACK_ORCHESTRATOR` variable to override the default orchestrator for
|
|
||||||
a given terminal session or a single Docker command. This variable can be unset
|
|
||||||
(the default, in which case Kubernetes is the orchestrator) or set to `swarm` or
|
|
||||||
`kubernetes`. The following command overrides the orchestrator for a single
|
|
||||||
deployment, by setting the variable{% if platform == "mac"" %}
|
|
||||||
at the start of the command itself.
|
|
||||||
|
|
||||||
```bash
|
|
||||||
DOCKER_STACK_ORCHESTRATOR=swarm docker stack deploy --compose-file /path/to/docker-compose.yml mystack
|
|
||||||
```{% elsif platform == "windows" %}
|
|
||||||
before running the command.
|
|
||||||
|
|
||||||
```shell
|
|
||||||
set DOCKER_STACK_ORCHESTRATOR=swarm
|
|
||||||
docker stack deploy --compose-file /path/to/docker-compose.yml mystack
|
|
||||||
```
|
|
||||||
|
|
||||||
{% endif %}
|
|
||||||
|
|
||||||
Alternatively, the `--orchestrator` flag may be set to `swarm` or `kubernetes`
|
|
||||||
when deploying to override the default orchestrator for that deployment.
|
|
||||||
|
|
||||||
```bash
|
|
||||||
docker stack deploy --orchestrator swarm --compose-file /path/to/docker-compose.yml mystack
|
|
||||||
```
|
|
||||||
|
|
||||||
> **Note**
|
|
||||||
>
|
|
||||||
> Deploying the same app in Kubernetes and swarm mode may lead to conflicts with
|
|
||||||
> ports and service names.
|
|
||||||
|
|
||||||
## Use the kubectl command
|
## Use the kubectl command
|
||||||
|
|
||||||
The {{ platform }} Kubernetes integration provides the Kubernetes CLI command
|
The {{ platform }} Kubernetes integration provides the Kubernetes CLI command
|
||||||
|
@ -139,35 +76,3 @@ kubectl get nodes
|
||||||
NAME STATUS ROLES AGE VERSION
|
NAME STATUS ROLES AGE VERSION
|
||||||
docker-desktop Ready master 3h v1.8.2
|
docker-desktop Ready master 3h v1.8.2
|
||||||
```
|
```
|
||||||
|
|
||||||
## Example app
|
|
||||||
|
|
||||||
Docker has created the following demo app that you can deploy to swarm mode or
|
|
||||||
to Kubernetes using the `docker stack deploy` command.
|
|
||||||
|
|
||||||
```yaml
|
|
||||||
version: "{{ site.compose_file_v3 }}"
|
|
||||||
|
|
||||||
services:
|
|
||||||
web:
|
|
||||||
image: dockersamples/k8s-wordsmith-web
|
|
||||||
ports:
|
|
||||||
- "80:80"
|
|
||||||
|
|
||||||
words:
|
|
||||||
image: dockersamples/k8s-wordsmith-api
|
|
||||||
deploy:
|
|
||||||
replicas: 5
|
|
||||||
endpoint_mode: dnsrr
|
|
||||||
resources:
|
|
||||||
limits:
|
|
||||||
memory: 50M
|
|
||||||
reservations:
|
|
||||||
memory: 50M
|
|
||||||
|
|
||||||
db:
|
|
||||||
image: dockersamples/k8s-wordsmith-db
|
|
||||||
```
|
|
||||||
|
|
||||||
If you already have a Kubernetes YAML file, you can deploy it using the
|
|
||||||
`kubectl` command.
|
|
||||||
|
|
Loading…
Reference in New Issue