# roles/web-app-xwiki/tasks/04_extensions.yml
#
# Canonical install flow for XWiki 16.10.x in this setup:
# - PUT /rest/jobs with query params (install, async=false, media=json, namespaces, extensions)
# - Pass lists via …
in query parameters
# - Minimal XML body () just to satisfy the REST layer
# - Restart once (handler: docker compose restart), then verify via the 'installed' repository
#
# Requires in xwiki.properties:
# extension.repositories=xwiki-public:maven:https://nexus.xwiki.org/nexus/content/groups/public/,central:maven:https://repo1.maven.org/maven2/
# 1) Probe what is already installed
- name: "Probe OIDC extension"
include_tasks: _probe_extension.yml
vars:
ext_id: "{{ XWIKI_EXT_OIDC_ID }}"
ext_version: "{{ XWIKI_EXT_OIDC_VERSION }}"
ext_enabled: "{{ XWIKI_OIDC_ENABLED }}"
result_var: "xwiki_oidc_ext"
- name: "Probe LDAP extension"
include_tasks: _probe_extension.yml
vars:
ext_id: "{{ XWIKI_EXT_LDAP_ID }}"
ext_version: "{{ XWIKI_EXT_LDAP_VERSION }}"
ext_enabled: "{{ XWIKI_LDAP_ENABLED }}"
result_var: "xwiki_ldap_ext"
# 2) Build the list of extensions to install (enabled + missing)
- name: "Initialize extension install list"
set_fact:
extensions_to_install: []
- name: "Queue OIDC extension for install"
when:
- XWIKI_OIDC_ENABLED | bool
- xwiki_oidc_ext.status | int != 200
set_fact:
extensions_to_install: "{{ extensions_to_install + [ {'id': XWIKI_EXT_OIDC_ID, 'version': XWIKI_EXT_OIDC_VERSION} ] }}"
- name: "Queue LDAP extension for install"
when:
- XWIKI_LDAP_ENABLED | bool
- xwiki_ldap_ext is defined
- xwiki_ldap_ext.status | int != 200
set_fact:
extensions_to_install: "{{ extensions_to_install + [ {'id': XWIKI_EXT_LDAP_ID, 'version': XWIKI_EXT_LDAP_VERSION} ] }}"
# 3) Build XML payloads for the request BODY (not query params)
- name: "Build XML payloads for job body"
when: extensions_to_install | length > 0
set_fact:
namespaces_xml_rest: "wiki:xwiki
"
extensions_xml_rest: >-
{% for ext in extensions_to_install -%}
{{ ext.id }}{{ ext.version }}wiki:xwiki
{%- endfor %}
# 4) Install extensions synchronously using BODY properties
- name: "Install extensions via PUT (body properties, sync)"
when: extensions_to_install | length > 0
uri:
url: "{{ XWIKI_REST_EXTENSION_INSTALL }}?jobType=install&async=false&media=json"
method: PUT
user: "{{ XWIKI_SUPERADMIN_USERNAME }}"
password: "{{ XWIKI_SUPERADMIN_PASSWORD }}"
force_basic_auth: true
headers:
Accept: "application/json"
Content-Type: "application/xml"
body: |
namespaces
extensions
interactive
false
status_code: [200, 201, 202]
return_content: yes
register: xwiki_install_job
notify: docker compose restart
changed_when: xwiki_install_job.json.state == 'FINISHED'
# 5) Restart once so new classes are loaded
- name: "Restart XWiki after install"
when: extensions_to_install | length > 0
meta: flush_handlers
# 6) Wait for REST to be ready again
- name: "Wait until XWiki REST is ready after restart"
uri:
url: "{{ XWIKI_REST_BASE }}"
status_code: [200, 401]
follow_redirects: none
return_content: no
register: xwiki_rest_up_after
changed_when: false
retries: 60
delay: 5
until:
- xwiki_rest_up_after is succeeded
- (xwiki_rest_up_after.redirected is not defined) or (not xwiki_rest_up_after.redirected)
# 7) Re-probe from 'installed' repository
- name: "Re-probe OIDC extension (installed repo)"
include_tasks: _probe_extension.yml
vars:
ext_id: "{{ XWIKI_EXT_OIDC_ID }}"
ext_version: "{{ XWIKI_EXT_OIDC_VERSION }}"
ext_enabled: "{{ XWIKI_OIDC_ENABLED }}"
result_var: "xwiki_oidc_ext_after"
- name: "Re-probe LDAP extension (installed repo)"
include_tasks: _probe_extension.yml
vars:
ext_id: "{{ XWIKI_EXT_LDAP_ID }}"
ext_version: "{{ XWIKI_EXT_LDAP_VERSION }}"
ext_enabled: "{{ XWIKI_LDAP_ENABLED }}"
result_var: "xwiki_ldap_ext_after"
# 8) Fail fast if something requested is still missing
- name: "FAIL: OIDC missing after install"
fail:
msg: >-
OIDC extension ({{ XWIKI_EXT_OIDC_ID }} {{ XWIKI_EXT_OIDC_VERSION }}) is NOT detected
after install (HTTP {{ xwiki_oidc_ext_after.status | default('n/a') }}).
Check 'extension.repositories' in xwiki.properties and network/DNS.
when:
- XWIKI_OIDC_ENABLED | bool
- xwiki_oidc_ext_after.status | int != 200
- name: "FAIL: LDAP missing after install"
fail:
msg: >-
LDAP extension ({{ XWIKI_EXT_LDAP_ID }} {{ XWIKI_EXT_LDAP_VERSION }}) is NOT detected
after install (HTTP {{ xwiki_ldap_ext_after.status | default('n/a') }}).
Check 'extension.repositories' in xwiki.properties and network/DNS.
when:
- XWIKI_LDAP_ENABLED | bool
- xwiki_ldap_ext_after.status | int != 200