Docker Volume
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
# 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. |