summaryrefslogtreecommitdiffstats
path: root/roles/openshift_ca/README.md
diff options
context:
space:
mode:
authorAndrew Butcher <abutcher@redhat.com>2016-05-17 10:24:41 -0400
committerAndrew Butcher <abutcher@redhat.com>2016-05-19 14:54:56 -0400
commitc9cd222f8eab56a31c6ff237739653672c7010af (patch)
tree10a0eea158d4e5360f90ccc65837012a87e9dcf4 /roles/openshift_ca/README.md
parentc78e91c7d4a304cc5d20135e96206008407c5f6f (diff)
downloadopenshift-c9cd222f8eab56a31c6ff237739653672c7010af.tar.gz
openshift-c9cd222f8eab56a31c6ff237739653672c7010af.tar.bz2
openshift-c9cd222f8eab56a31c6ff237739653672c7010af.tar.xz
openshift-c9cd222f8eab56a31c6ff237739653672c7010af.zip
Consolidate ca/master/node certificates roles into openshift_certificates.
Diffstat (limited to 'roles/openshift_ca/README.md')
-rw-r--r--roles/openshift_ca/README.md48
1 files changed, 48 insertions, 0 deletions
diff --git a/roles/openshift_ca/README.md b/roles/openshift_ca/README.md
new file mode 100644
index 000000000..96c9cd5f2
--- /dev/null
+++ b/roles/openshift_ca/README.md
@@ -0,0 +1,48 @@
+OpenShift CA
+============
+
+This role delegates all tasks to the `openshift_ca_host` such that this role can be depended on by other OpenShift certificate roles.
+
+Requirements
+------------
+
+Role Variables
+--------------
+
+From this role:
+
+| Name | Default value | Description |
+|-------------------------|-----------------------------------------------|-----------------------------------------------------------------------------|
+| openshift_ca_host | None (Required) | The hostname of the system where the OpenShift CA will be created. |
+| openshift_ca_config_dir | `{{ openshift.common.config_base }}/master` | CA certificate directory. |
+| openshift_ca_cert | `{{ openshift_ca_config_dir }}/ca.crt` | CA certificate path including CA certificate filename. |
+| openshift_ca_key | `{{ openshift_ca_config_dir }}/ca.key` | CA key path including CA key filename. |
+| openshift_ca_serial | `{{ openshift_ca_config_dir }}/ca.serial.txt` | CA serial path including CA serial filename. |
+| openshift_version | `{{ openshift_pkg_version }}` | OpenShift package version. |
+
+Dependencies
+------------
+
+* openshift_repos
+* openshift_cli
+
+Example Playbook
+----------------
+
+```
+- name: Create OpenShift CA
+ hosts: localhost
+ roles:
+ - role: openshift_ca
+ openshift_ca_host: master1.example.com
+```
+
+License
+-------
+
+Apache License Version 2.0
+
+Author Information
+------------------
+
+Jason DeTiberus (jdetiber@redhat.com)