mirror of https://github.com/docker/docs.git
39 lines
1.9 KiB
Markdown
39 lines
1.9 KiB
Markdown
---
|
|
title: docker/dtr remove
|
|
description: Remove a DTR replica from a cluster
|
|
keywords: dtr, cli, remove
|
|
---
|
|
|
|
Remove a DTR replica from a cluster
|
|
|
|
## Usage
|
|
|
|
```bash
|
|
docker run -it --rm docker/dtr \
|
|
remove [command options]
|
|
```
|
|
|
|
## Description
|
|
|
|
|
|
This command gracefully scales down your DTR cluster by removing exactly
|
|
one replica. All other replicas must be healthy and will remain healthy after
|
|
this operation.
|
|
|
|
|
|
## Options
|
|
|
|
| Option | Environment Variable | Description |
|
|
|:------------------------------|:--------------------------|:-------------------------------------------------------------------------------------|
|
|
| `--debug` | $DEBUG | Enable debug mode for additional logs. |
|
|
| `--existing-replica-id` | $DTR_REPLICA_ID | The ID of an existing DTR replica. To add, remove or modify DTR, you must connect to an existing healthy replica's database. |
|
|
| `--help-extended` | $DTR_EXTENDED_HELP | Display extended help text for a given command. |
|
|
| `--replica-id` | $DTR_REMOVE_REPLICA_ID | DEPRECATED Alias for `--replica-ids`. |
|
|
| `--replica-ids` | $DTR_REMOVE_REPLICA_IDS | A comma separated list of IDs of replicas to remove from the cluster. |
|
|
| `--ucp-ca` | $UCP_CA | Use a PEM-encoded TLS CA certificate for UCP. Download the UCP TLS CA certificate from `https://<ucp-url>/ca`, and use `--ucp-ca "$(cat ca.pem)"`. |
|
|
| `--ucp-insecure-tls` | $UCP_INSECURE_TLS | Disable TLS verification for UCP. The installation uses TLS but always trusts the TLS certificate used by UCP, which can lead to MITM (man-in-the-middle) attacks. For production deployments, use `--ucp-ca "$(cat ca.pem)"` instead. |
|
|
| `--ucp-password` | $UCP_PASSWORD | The UCP administrator password. |
|
|
| `--ucp-url` | $UCP_URL | The UCP URL including domain and port. |
|
|
| `--ucp-username` | $UCP_USERNAME | The UCP administrator username. |
|
|
|