| commit | ebd6231006fbd70586beb1b6ddb8dd493de44da8 | [log] [tgz] |
|---|---|---|
| author | Carlos Frias <friasc@google.com> | Wed May 02 17:47:27 2018 -0400 |
| committer | Carlos Frias <friasc@google.com> | Wed May 02 17:47:27 2018 -0400 |
| tree | 2926fdcba0228decaf3bcccf774e0a934195076e | |
| parent | 3bc55bb806b47b03ea0431375de4de2601ee4722 [diff] |
Updated README.md file
This roles setups the minimum operating system packages and configs that would allow OPDK to function properly. This is a bare bones setup that can be considered a starting point but by no means the full OS setup.
The installation of Apigee OPDK requires root access as does the installation of the system updates that are the focus of this role. Credentials must also be supplied to override the empty placeholders provided here. It is recommended that credentials be consolidated into a single credentials.yml file that can be stored separately. It is assumed that credentials are stored in ~/.apigee-secure/credentials.yml.
Please note that IPV6 is disabled in this role. If you need to by-pass this functionality because IPV6 is already being disabled on a system then you can accomplish this by invoking the playbook with the --skip-tags flag like this:
ansible-playbook install-edge.yml --skip-tags=ipv6
Additional information regarding how Ansible uses tags can be obtained here.
| Variable Name | Default Value | Description |
|---|---|---|
| apigee_continue_on_warning | y | Defaults for internal environment OPDK setup settings |
| vm_swappiness | 60 | Default value to limit swap file use |
| epel_ol6 | https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm | Default epel repo for EL 6 |
| epel_rhel7 | https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm | Default epel repo for EL 7 |
Yum system packages can be set using the yum_packages collection. This can be modified at installation. The default packages are listed as:
yum_packages: - bind-utils - chkconfig - curl - tar - wget - yum-utils - unzip - rsync - which - libselinux-python - nss - openssh-clients - openssh-server - grep - rpm - rng-tools - sed
Sysctl require changes to ensure the smooth operation of Edge. The attributes and values are set using the sysctl_minimum collection. The default values are listed as:
sysctl_minimum:
- { name: 'vm.swappiness', value: "{{ vm_swappiness }}" }
- { name: 'net.ipv6.conf.all.disable_ipv6', value: '1' }
- { name: 'net.ipv6.conf.default.disable_ipv6', value: '1' }
- { name: 'net.ipv4.tcp_fin_timeout', value: "{{ apigee_net_ipv4_tcp_fin_timeout }}" }
- { name: 'vm.max_map_count', value: '{{ apigee_max_map_count }}' }
This role depends on apigee-opdk-yum-packages.
- hosts: servers
roles:
- { role: apigee-opdk-setup-os-minimum }
Apache License Version 2.0, January 2004
Carlos Frias
This is not an officially supported Google product.
We'd love to accept your patches and contributions to this project. Please review our guidelines.