[SKIP CI] update readme

This commit is contained in:
Drone Shipper 2019-10-16 20:31:43 +00:00
parent e1cd1e590e
commit 5a36ad6c29

219
README.md
View File

@ -1,59 +1,220 @@
# sit-lnx.docker-engine
# xoxys.docker-engine
[![Build Status](https://drone.rknet.org/api/badges/ansible/xoxys.docker-engine/status.svg)](https://drone.rknet.org/ansible/xoxys.docker-engine)
Install docker engine. Currently only overlay2 as storage engine is supported.
**Supported OS**
Install Docker Engine
* RHEL7
## Table of content
### Role Variables
* [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