nicole
289769a601
Automatic Documentation Deployment / Sync Docs to https://kb.bunny-lab.io (push) Successful in 8s
44 lines
1.8 KiB
Markdown
44 lines
1.8 KiB
Markdown
---
|
|
tags:
|
|
- Ansible
|
|
- Automation
|
|
---
|
|
|
|
## Purpose
|
|
Explain how AWX inventories describe hosts, groups, and connection variables. Use the lab inventory for environment-specific host records.
|
|
|
|
Keep in mind the "Group Variables" section varies based on your environment. NTLM is considered insecure, but may be necessary when you are interacting with Windows servers that are not domain-joined. Otherwise you want to use Kerberos authentication. This is outlined more in the [AWX Kerberos Implementation](<../../../workflows/Automation/AWX/AWX Kerberos Implementation.md#job-template-and-inventory-examples>) documentation.
|
|
|
|
!!! note "Inventory Data Relationships"
|
|
An inventory file consists of hosts, groups, and variables. A host belongs to a group, and a group can have variables configured for it. If you run a playbook / job template against a host, it will assign the variables associated to the group that host belongs to (if any) during runtime.
|
|
|
|
```ini title="https://git.bunny-lab.io/GitOps/awx.bunny-lab.io/src/branch/main/inventories/homelab.ini"
|
|
# Networking
|
|
pfsense-example ansible_host=192.168.3.1
|
|
|
|
# Servers
|
|
example01 ansible_host=192.168.3.2
|
|
example02 ansible_host=192.168.3.3
|
|
example03 ansible_host=example03.domain.com # FQDN is required for Ansible in Windows Domain-Joined Kerberos environments.
|
|
example04 ansible_host=example04.domain.com # FQDN is required for Ansible in Windows Domain-Joined Kerberos environments.
|
|
|
|
# Group Definitions
|
|
[linuxServers]
|
|
example01
|
|
example02
|
|
|
|
[domainControllers]
|
|
example03
|
|
example04
|
|
|
|
[domainControllers:vars]
|
|
ansible_connection=winrm
|
|
ansible_winrm_kerberos_delegation=false
|
|
ansible_port=5986
|
|
ansible_winrm_transport=ntlm
|
|
ansible_winrm_server_cert_validation=ignore
|
|
```
|
|
|
|
## Related Documentation
|
|
- [Related AWX Documentation](<index.md>) — Find the connected deployments, procedures, and references for this subject.
|