mirror of
https://github.com/freeipa/ansible-freeipa.git
synced 2026-07-25 00:44:42 +00:00
Modify roles README for consistency.
Modify examples in server and replica roles for consistency with client role, by defining language for code blocks.
This commit is contained in:
@@ -47,60 +47,72 @@ Usage
|
|||||||
|
|
||||||
Example inventory file with fixed principal using auto-discovery with DNS records:
|
Example inventory file with fixed principal using auto-discovery with DNS records:
|
||||||
|
|
||||||
[ipareplicas]
|
```ini
|
||||||
ipareplica1.example.com
|
[ipareplicas]
|
||||||
ipareplica2.example.com
|
ipareplica1.example.com
|
||||||
|
ipareplica2.example.com
|
||||||
|
|
||||||
[ipareplicas:vars]
|
[ipareplicas:vars]
|
||||||
ipaadmin_principal=admin
|
ipaadmin_principal=admin
|
||||||
|
```
|
||||||
|
|
||||||
Example playbook to setup the IPA client(s) using principal from inventory file and password from an [Ansible Vault](http://docs.ansible.com/ansible/latest/playbooks_vault.html) file:
|
Example playbook to setup the IPA client(s) using principal from inventory file and password from an [Ansible Vault](http://docs.ansible.com/ansible/latest/playbooks_vault.html) file:
|
||||||
|
|
||||||
- name: Playbook to configure IPA replicas
|
```yaml
|
||||||
hosts: ipareplicas
|
---
|
||||||
become: true
|
- name: Playbook to configure IPA replicas
|
||||||
vars_files:
|
hosts: ipareplicas
|
||||||
- playbook_sensitive_data.yml
|
become: true
|
||||||
|
vars_files:
|
||||||
|
- playbook_sensitive_data.yml
|
||||||
|
|
||||||
roles:
|
roles:
|
||||||
- role: ipareplica
|
- role: ipareplica
|
||||||
state: present
|
state: present
|
||||||
|
```
|
||||||
|
|
||||||
Example playbook to unconfigure the IPA client(s) using principal and password from inventory file:
|
Example playbook to unconfigure the IPA client(s) using principal and password from inventory file:
|
||||||
|
|
||||||
- name: Playbook to unconfigure IPA replicas
|
```yaml
|
||||||
hosts: ipareplicas
|
---
|
||||||
become: true
|
- name: Playbook to unconfigure IPA replicas
|
||||||
|
hosts: ipareplicas
|
||||||
|
become: true
|
||||||
|
|
||||||
roles:
|
roles:
|
||||||
- role: ipareplica
|
- role: ipareplica
|
||||||
state: absent
|
state: absent
|
||||||
|
```
|
||||||
|
|
||||||
Example inventory file with fixed server, principal, password and domain:
|
Example inventory file with fixed server, principal, password and domain:
|
||||||
|
|
||||||
[ipaserver]
|
```ini
|
||||||
ipaserver.example.com
|
[ipaserver]
|
||||||
|
ipaserver.example.com
|
||||||
|
|
||||||
[ipareplicas]
|
[ipareplicas]
|
||||||
ipareplica1.example.com
|
ipareplica1.example.com
|
||||||
ipareplica2.example.com
|
ipareplica2.example.com
|
||||||
|
|
||||||
[ipareplicas:vars]
|
[ipareplicas:vars]
|
||||||
ipaclient_domain=example.com
|
ipaclient_domain=example.com
|
||||||
ipaadmin_principal=admin
|
ipaadmin_principal=admin
|
||||||
ipaadmin_password=MySecretPassword123
|
ipaadmin_password=MySecretPassword123
|
||||||
ipadm_password=MySecretPassword456
|
ipadm_password=MySecretPassword456
|
||||||
|
```
|
||||||
|
|
||||||
Example playbook to setup the IPA client(s) using principal and password from inventory file:
|
Example playbook to setup the IPA client(s) using principal and password from inventory file:
|
||||||
|
|
||||||
- name: Playbook to configure IPA replicas with username/password
|
```yaml
|
||||||
hosts: ipareplicas
|
---
|
||||||
become: true
|
- name: Playbook to configure IPA replicas with username/password
|
||||||
|
hosts: ipareplicas
|
||||||
roles:
|
become: true
|
||||||
- role: ipareplica
|
|
||||||
state: present
|
|
||||||
|
|
||||||
|
roles:
|
||||||
|
- role: ipareplica
|
||||||
|
state: present
|
||||||
|
```
|
||||||
|
|
||||||
Playbooks
|
Playbooks
|
||||||
=========
|
=========
|
||||||
|
|||||||
@@ -42,8 +42,7 @@ Requirements
|
|||||||
Limitations
|
Limitations
|
||||||
-----------
|
-----------
|
||||||
|
|
||||||
External signed CA
|
**External signed CA**
|
||||||
|
|
||||||
External signed CA is now supported. But the currently needed two step process is an issue for the processing in a simple playbook.
|
External signed CA is now supported. But the currently needed two step process is an issue for the processing in a simple playbook.
|
||||||
|
|
||||||
Work is planned to have a new method to handle CSR for external signed CAs in a separate step before starting the server installation.
|
Work is planned to have a new method to handle CSR for external signed CAs in a separate step before starting the server installation.
|
||||||
@@ -54,57 +53,70 @@ Usage
|
|||||||
|
|
||||||
Example inventory file with fixed domain and realm, setting up of the DNS server and using forwarders from /etc/resolv.conf:
|
Example inventory file with fixed domain and realm, setting up of the DNS server and using forwarders from /etc/resolv.conf:
|
||||||
|
|
||||||
[ipaserver]
|
```ini
|
||||||
ipaserver2.example.com
|
[ipaserver]
|
||||||
|
ipaserver2.example.com
|
||||||
|
|
||||||
[ipaserver:vars]
|
[ipaserver:vars]
|
||||||
ipaserver_domain=example.com
|
ipaserver_domain=example.com
|
||||||
ipaserver_realm=EXAMPLE.COM
|
ipaserver_realm=EXAMPLE.COM
|
||||||
ipaserver_setup_dns=yes
|
ipaserver_setup_dns=yes
|
||||||
ipaserver_auto_forwarders=yes
|
ipaserver_auto_forwarders=yes
|
||||||
|
```
|
||||||
|
|
||||||
Example playbook to setup the IPA server using admin and dirman passwords from an [Ansible Vault](http://docs.ansible.com/ansible/latest/playbooks_vault.html) file:
|
Example playbook to setup the IPA server using admin and dirman passwords from an [Ansible Vault](http://docs.ansible.com/ansible/latest/playbooks_vault.html) file:
|
||||||
|
|
||||||
- name: Playbook to configure IPA server
|
```yaml
|
||||||
hosts: ipaserver
|
---
|
||||||
become: true
|
- name: Playbook to configure IPA server
|
||||||
vars_files:
|
hosts: ipaserver
|
||||||
- playbook_sensitive_data.yml
|
become: true
|
||||||
|
vars_files:
|
||||||
|
- playbook_sensitive_data.yml
|
||||||
|
|
||||||
roles:
|
roles:
|
||||||
- role: ipaserver
|
- role: ipaserver
|
||||||
state: present
|
state: present
|
||||||
|
```
|
||||||
|
|
||||||
Example playbook to unconfigure the IPA client(s) using principal and password from inventory file:
|
Example playbook to unconfigure the IPA client(s) using principal and password from inventory file:
|
||||||
|
|
||||||
- name: Playbook to unconfigure IPA server
|
```yaml
|
||||||
hosts: ipaserver
|
---
|
||||||
become: true
|
- name: Playbook to unconfigure IPA server
|
||||||
|
hosts: ipaserver
|
||||||
|
become: true
|
||||||
|
|
||||||
roles:
|
roles:
|
||||||
- role: ipaserver
|
- role: ipaserver
|
||||||
state: absent
|
state: absent
|
||||||
|
```
|
||||||
|
|
||||||
Example inventory file with fixed domain, realm, admin and dirman passwords:
|
Example inventory file with fixed domain, realm, admin and dirman passwords:
|
||||||
|
|
||||||
[ipaserver]
|
```ini
|
||||||
ipaserver.example.com
|
[ipaserver]
|
||||||
|
ipaserver.example.com
|
||||||
|
|
||||||
[ipaserver:vars]
|
[ipaserver:vars]
|
||||||
ipaserver_domain=example.com
|
ipaserver_domain=example.com
|
||||||
ipaserver_realm=EXAMPLE.COM
|
ipaserver_realm=EXAMPLE.COM
|
||||||
ipaadmin_password=MySecretPassword123
|
ipaadmin_password=MySecretPassword123
|
||||||
ipadm_password=MySecretPassword234
|
ipadm_password=MySecretPassword234
|
||||||
|
```
|
||||||
|
|
||||||
Example playbook to setup the IPA server using admin and dirman passwords from inventory file:
|
Example playbook to setup the IPA server using admin and dirman passwords from inventory file:
|
||||||
|
|
||||||
- name: Playbook to configure IPA server
|
```yaml
|
||||||
hosts: ipaserver
|
---
|
||||||
become: true
|
- name: Playbook to configure IPA server
|
||||||
|
hosts: ipaserver
|
||||||
|
become: true
|
||||||
|
|
||||||
roles:
|
roles:
|
||||||
- role: ipaserver
|
- role: ipaserver
|
||||||
state: present
|
state: present
|
||||||
|
```
|
||||||
|
|
||||||
Example playbook to setup the IPA primary with external signed CA using the previous inventory file:
|
Example playbook to setup the IPA primary with external signed CA using the previous inventory file:
|
||||||
|
|
||||||
@@ -135,6 +147,7 @@ Sign with CA: This is up to you
|
|||||||
Server installation step 2: Copy `<ipaserver hostname>-chain.crt` to the IPA server and continue with installation of the primary.
|
Server installation step 2: Copy `<ipaserver hostname>-chain.crt` to the IPA server and continue with installation of the primary.
|
||||||
|
|
||||||
```yaml
|
```yaml
|
||||||
|
---
|
||||||
- name: Playbook to configure IPA server step3
|
- name: Playbook to configure IPA server step3
|
||||||
hosts: ipaserver
|
hosts: ipaserver
|
||||||
become: true
|
become: true
|
||||||
|
|||||||
Reference in New Issue
Block a user