---
title: Docker Volume
slug: homologacao-atmosphere/docker-volume
description: Learn how to create and delete Docker volumes with this comprehensive document. Discover the essential parameters like volume driver, driver options, labels, force, recreate, state, and volume name. Explore practical examples for creating and deleting vol
docTags:
createdAt: 2021-03-17T19:59:00.000Z
---
## Resumo
- Criar e excluir volumes Docker.
## Parâmetros
| **Parâmetro** | **Tipo** | **Escolhas \| Valor Padrão** | **Comentários** |
| ------------------------------------------------------------- | ---------- | -------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| driver | string | - "local"
(default) | Especifique o tipo de volume. O Docker fornece o driver local, mas drivers de terceiros também podem ser usados. |
| driver\_options | dictionary | | Dicionário de configurações de volume. Consulte os docs do docker para opções e valores válidos: https\://docs.docker.com/engine/reference/commandline/volume\_create/#driver-specific-options |
| labels | dictionary | | Dicionário de chave / valores de rótulo para definir no volume. |
| force | boolean | Escolhas:
- false
(default)
- true | Se a escolha for true, forçará com que o volume seja excluído e recriado se o mesmo já exista. Isso fará com que todos os dados existentes no volume seja deletado. |
| recreate | string | Escolhas:
- always
- never
(default)
- options-changed | Controla quando um volume será recriado quando o estado estiver presente. Observe que recriar um volume existente fará com que **quaisquer dados no volume existente sejam perdidos! O volume será excluído e um novo volume com o mesmo nome será criado. O valor sempre força o volume a ser sempre recriado.** O valor nunca garante que o volume não será recriado. O valor options-changed garante que o volume será recriado se o volume já existir e o driver, opções do driver ou rótulos forem diferentes. |
| state | string | Escolhas:
- present
(default)
- absent | absent - apaga o volume.
present - cria o volume, se ainda não existir. |
| volume\_name - *required * | string | | Nome do volume à ser operado. |
Exemplos
--------
```yaml
# Exemplo: Criar um volume
- docker_volume:
volume_name: volume_one
# Exemplo: Excluir um volume
- docker_volume:
volume_name: volume_one
state: absent
# Exemplo: Criar um volume com opções
- docker_volume:
volume_name: volume_two
driver_options:
type: btrfs
device: /dev/sda2
```
## Valores retornados
| **Chave** | **Tipo** | **Retornado **
**quando** | **Descrição** |
| --------- | ---------- | ----------------------------------- | ------------------------------------------------------- |
| volume | dictionary | Sucesso | Resultados da inspeção de volume para o volume afetado. |