[SKIP CI] update readme
This commit is contained in:
parent
e1cd1e590e
commit
5a36ad6c29
219
README.md
219
README.md
@ -1,59 +1,220 @@
|
||||
# sit-lnx.docker-engine
|
||||
# xoxys.docker-engine
|
||||
|
||||
Install docker engine. Currently only overlay2 as storage engine is supported.
|
||||
[![Build Status](https://drone.rknet.org/api/badges/ansible/xoxys.docker-engine/status.svg)](https://drone.rknet.org/ansible/xoxys.docker-engine)
|
||||
|
||||
**Supported OS**
|
||||
|
||||
* RHEL7
|
||||
Install Docker Engine
|
||||
|
||||
### Role Variables
|
||||
## Table of content
|
||||
|
||||
* [Default Variables](#default-variables)
|
||||
* [dockerengine_package](#dockerengine_package)
|
||||
* [dockerengine_packages_extra](#dockerengine_packages_extra)
|
||||
* [dockerengine_docker_group_enabled](#dockerengine_docker_group_enabled)
|
||||
* [dockerengine_secure_registries](#dockerengine_secure_registries)
|
||||
* [dockerengine_insecure_registries](#dockerengine_insecure_registries)
|
||||
* [dockerengine_block_registries](#dockerengine_block_registries)
|
||||
* [dockerengine_storage_vg](#dockerengine_storage_vg)
|
||||
* [dockerengine_storage_lv](#dockerengine_storage_lv)
|
||||
* [dockerengine_storage_size](#dockerengine_storage_size)
|
||||
* [dockerengine_base_dir](#dockerengine_base_dir)
|
||||
* [dockerengine_cli_options](#dockerengine_cli_options)
|
||||
* [dockerengine_usernamespace_enabled](#dockerengine_usernamespace_enabled)
|
||||
* [dockerengine_nsremap_user](#dockerengine_nsremap_user)
|
||||
* [dockerengine_nsremap_range_start](#dockerengine_nsremap_range_start)
|
||||
* [dockerengine_nsremap_range_length](#dockerengine_nsremap_range_length)
|
||||
* [dockerengine_http_proxy](#dockerengine_http_proxy)
|
||||
* [dockerengine_https_proxy](#dockerengine_https_proxy)
|
||||
* [dockerengine_no_proxy](#dockerengine_no_proxy)
|
||||
* [dockerengine_storage_pvs](#dockerengine_storage_pvs)
|
||||
* [Dependencies](#dependencies)
|
||||
* [License](#license)
|
||||
* [Author](#author)
|
||||
|
||||
```yaml
|
||||
---
|
||||
|
||||
## Default Variables
|
||||
|
||||
### dockerengine_package
|
||||
|
||||
#### Default value
|
||||
|
||||
```YAML
|
||||
dockerengine_package: docker
|
||||
dockerengine_docker_group_enabled: False
|
||||
```
|
||||
|
||||
### dockerengine_packages_extra
|
||||
|
||||
The role requires epel repository and pip to work .You can use `dockerengine_packages_extra` to install these dependencys.
|
||||
|
||||
#### Default value
|
||||
|
||||
```YAML
|
||||
dockerengine_packages_extra: []
|
||||
```
|
||||
|
||||
#### Example usage
|
||||
|
||||
```YAML
|
||||
dockerengine_packages_extra:
|
||||
- epel-release
|
||||
- python2-pip
|
||||
```
|
||||
|
||||
### dockerengine_docker_group_enabled
|
||||
|
||||
#### Default value
|
||||
|
||||
```YAML
|
||||
dockerengine_docker_group_enabled: false
|
||||
```
|
||||
|
||||
### dockerengine_secure_registries
|
||||
|
||||
#### Default value
|
||||
|
||||
```YAML
|
||||
dockerengine_secure_registries: []
|
||||
```
|
||||
|
||||
### dockerengine_insecure_registries
|
||||
|
||||
#### Default value
|
||||
|
||||
```YAML
|
||||
dockerengine_insecure_registries: []
|
||||
```
|
||||
|
||||
### dockerengine_block_registries
|
||||
|
||||
#### Default value
|
||||
|
||||
```YAML
|
||||
dockerengine_block_registries: []
|
||||
```
|
||||
|
||||
# dockerengine_http_proxy: # defaults to not set
|
||||
# dockerengine_https_proxy: # defaults to not set
|
||||
# dockerengine_no_proxy: # defaults to not set
|
||||
### dockerengine_storage_vg
|
||||
|
||||
# dockerengine_storage_pvs: /dev/sdx # defaults to not set
|
||||
#### Default value
|
||||
|
||||
```YAML
|
||||
dockerengine_storage_vg: vg_docker
|
||||
dockerengine_storage_lv: lv_docker
|
||||
dockerengine_storage_size: 100G
|
||||
dockerengine_base_dir: /var/lib/docker
|
||||
```
|
||||
|
||||
### dockerengine_storage_lv
|
||||
|
||||
#### Default value
|
||||
|
||||
```YAML
|
||||
dockerengine_storage_lv: lv_docker
|
||||
```
|
||||
|
||||
### dockerengine_storage_size
|
||||
|
||||
#### Default value
|
||||
|
||||
```YAML
|
||||
dockerengine_storage_size: 100G
|
||||
```
|
||||
|
||||
### dockerengine_base_dir
|
||||
|
||||
#### Default value
|
||||
|
||||
```YAML
|
||||
dockerengine_base_dir: /var/lib/docker
|
||||
```
|
||||
|
||||
### dockerengine_cli_options
|
||||
|
||||
#### Default value
|
||||
|
||||
```YAML
|
||||
dockerengine_cli_options:
|
||||
- selinux-enabled
|
||||
- log-driver=journald
|
||||
- log-level=info
|
||||
- signature-verification=false
|
||||
|
||||
```
|
||||
|
||||
### Examples
|
||||
### dockerengine_usernamespace_enabled
|
||||
|
||||
#### Playbook
|
||||
#### Default value
|
||||
|
||||
```yaml
|
||||
---
|
||||
- hosts: docker-engine
|
||||
|
||||
roles:
|
||||
- sit-lnx.docker-engine
|
||||
```YAML
|
||||
dockerengine_usernamespace_enabled: false
|
||||
```
|
||||
|
||||
### Dependencies
|
||||
### dockerengine_nsremap_user
|
||||
|
||||
* you need the `wrap` custom filter from
|
||||
#### Default value
|
||||
|
||||
### Maintainer
|
||||
```YAML
|
||||
dockerengine_nsremap_user: dockremap
|
||||
```
|
||||
|
||||
[Robert Kaussow](https://gitea.rknet.org/xoxys)
|
||||
### dockerengine_nsremap_range_start
|
||||
|
||||
### License
|
||||
#### Default value
|
||||
|
||||
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details
|
||||
```YAML
|
||||
dockerengine_nsremap_range_start: 231072
|
||||
```
|
||||
|
||||
### dockerengine_nsremap_range_length
|
||||
|
||||
#### Default value
|
||||
|
||||
```YAML
|
||||
dockerengine_nsremap_range_length: 65536
|
||||
```
|
||||
|
||||
### dockerengine_http_proxy
|
||||
|
||||
#### Default value
|
||||
|
||||
```YAML
|
||||
dockerengine_http_proxy: _unset_
|
||||
```
|
||||
|
||||
### dockerengine_https_proxy
|
||||
|
||||
#### Default value
|
||||
|
||||
```YAML
|
||||
dockerengine_https_proxy: _unset
|
||||
```
|
||||
|
||||
### dockerengine_no_proxy
|
||||
|
||||
#### Default value
|
||||
|
||||
```YAML
|
||||
dockerengine_no_proxy: _unset_
|
||||
```
|
||||
|
||||
### dockerengine_storage_pvs
|
||||
|
||||
#### Default value
|
||||
|
||||
```YAML
|
||||
dockerengine_storage_pvs: _unset_
|
||||
```
|
||||
|
||||
#### Example usage
|
||||
|
||||
```YAML
|
||||
dockerengine_storage_pvs: /dev/sda
|
||||
```
|
||||
|
||||
## Dependencies
|
||||
|
||||
None.
|
||||
|
||||
## License
|
||||
|
||||
MIT
|
||||
|
||||
## Author
|
||||
|
||||
Robert Kaussow
|
||||
|
Loading…
Reference in New Issue
Block a user