Update nextcloud/update_nextcloud_v2.yml

This commit is contained in:
2026-01-23 16:21:41 +00:00
parent ebfe720397
commit 46955aea0d

View File

@@ -1,287 +1,113 @@
# nextcloud/update_nextcloud.yml - name: Update Nextcloud (Ansible-native)
hosts: proxmox_nextcloud
- name: Update Nextcloud on VM via Proxmox
hosts: proxmox_nextcloud # linux_servers
gather_facts: false
become: true become: true
become_user: root gather_facts: false
become_method: sudo
vars: vars:
# --- Connection to VM (provided by Semaphore env vars) ---
vm_ip: "{{ lookup('env', 'VM_IP') }}"
vm_user: "{{ lookup('env', 'VM_USER') }}"
vm_pass: "{{ lookup('env', 'VM_PASS') }}"
use_sudo: false
# --- Debug / retries ---
DEBUG: "{{ lookup('env', 'DEBUG') | default(0) | int }}" DEBUG: "{{ lookup('env', 'DEBUG') | default(0) | int }}"
RETRIES: "{{ lookup('env', 'RETRIES') | default(25) | int }}" RETRIES: "{{ lookup('env', 'RETRIES') | default(25) | int }}"
# --- Nextcloud specifics ---
nextcloud_project: "nextcloud-collabora" nextcloud_project: "nextcloud-collabora"
nextcloud_compose_file: "/data/compose/nextcloud/docker-compose-nextcloud.yml" compose_file: "/data/compose/nextcloud/docker-compose-nextcloud.yml"
nextcloud_service: "nextcloud" backup_dir: "/data/compose/nextcloud/backup-{{ ansible_date_time.iso8601_basic_short }}"
# Backup directory on the VM (timestamped on controller)
backup_dir: "/data/compose/nextcloud/backup-{{ lookup('pipe', 'date +%F-%H%M%S') }}"
nextcloud_base_url: "https://cloud.martinfencl.eu" nextcloud_base_url: "https://cloud.martinfencl.eu"
nextcloud_status_url: "{{ nextcloud_base_url }}/status.php" nextcloud_status_url: "{{ nextcloud_base_url }}/status.php"
# Docker command prefix (consistent behavior and quiet hints)
docker_prefix: "unalias docker 2>/dev/null || true; DOCKER_CLI_HINTS=0; command docker"
# --- Backup phase commands (run on VM) ---
nextcloud_backup_commands:
- >-
mkdir -p "{{ backup_dir }}"
- >-
{{ docker_prefix }} exec -u www-data nextcloud php occ maintenance:mode --on
- >-
{{ docker_prefix }} exec nextcloud sh -c 'tar czf /tmp/nextcloud_conf.tgz -C /var/www/html config custom_apps'
- >-
{{ docker_prefix }} cp nextcloud:/tmp/nextcloud_conf.tgz "{{ backup_dir }}/nextcloud_conf.tgz"
- >-
{{ docker_prefix }} exec nextcloud rm /tmp/nextcloud_conf.tgz || true
- >-
{{ docker_prefix }} exec nextcloud-db sh -c 'command -v mariadb-dump >/dev/null && mariadb-dump -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" "$MYSQL_DATABASE" || mysqldump -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" "$MYSQL_DATABASE"' > "{{ backup_dir }}/db.sql"
# --- Upgrade phase commands (run on VM) ---
nextcloud_upgrade_commands:
- >-
{{ docker_prefix }} compose -p {{ nextcloud_project }} -f {{ nextcloud_compose_file }} pull {{ nextcloud_service }}
- >-
{{ docker_prefix }} compose -p {{ nextcloud_project }} -f {{ nextcloud_compose_file }} up -d --no-deps --force-recreate {{ nextcloud_service }}
- >-
{{ docker_prefix }} exec -u www-data nextcloud php occ maintenance:mode --off
- >-
{{ docker_prefix }} exec -u www-data nextcloud php occ upgrade
- >-
{{ docker_prefix }} exec -u www-data nextcloud php occ app:update --all || true
- >-
{{ docker_prefix }} exec -u www-data nextcloud php occ maintenance:repair --include-expensive || true
- >-
{{ docker_prefix }} exec -u www-data nextcloud php occ maintenance:mode --on
tasks: tasks:
- name: Ensure sshpass is installed (for password-based SSH) # -------------------------
ansible.builtin.apt: # Pre-check
name: sshpass # -------------------------
state: present - name: Show current Nextcloud version (DEBUG)
update_cache: yes command: docker exec -u www-data nextcloud php occ -V
register: nc_version
- name: Nextcloud | Show current version before upgrade (DEBUG)
ansible.builtin.command:
argv:
- sshpass
- -e
- ssh
- -o
- StrictHostKeyChecking=no
- -o
- ConnectTimeout=15
- "{{ vm_user }}@{{ vm_ip }}"
- bash
- -lc
- 'docker exec -u www-data nextcloud php occ -V || true'
environment:
SSHPASS: "{{ vm_pass }}"
register: nc_version_before
changed_when: false changed_when: false
failed_when: false failed_when: false
when: DEBUG == 1 when: DEBUG == 1
# ------------------------- - debug:
# Backup phase var: nc_version.stdout
# -------------------------
- name: Nextcloud | Run backup commands on VM (via SSH) # run plain commands via SSH
ansible.builtin.command:
argv:
- sshpass
- -e
- ssh
- -o
- StrictHostKeyChecking=no
- -o
- ConnectTimeout=15
- "{{ vm_user }}@{{ vm_ip }}"
- "{{ ('sudo ' if use_sudo else '') + item }}"
environment:
SSHPASS: "{{ vm_pass }}"
loop: "{{ nextcloud_backup_commands }}"
loop_control:
index_var: idx
label: "backup-cmd-{{ idx }}"
register: nc_backup_cmds
changed_when: false
no_log: "{{ DEBUG == 0 }}"
- name: Nextcloud | Show outputs of backup commands (DEBUG)
ansible.builtin.debug:
msg: |
CMD: {{ item.item }}
RC: {{ item.rc }}
STDOUT:
{{ (item.stdout | default('')).strip() }}
STDERR:
{{ (item.stderr | default('')).strip() }}
loop: "{{ nc_backup_cmds.results }}"
when: DEBUG == 1 when: DEBUG == 1
- name: Nextcloud | Fail play if any backup command failed # -------------------------
ansible.builtin.assert: # Backup
that: "item.rc == 0" # -------------------------
fail_msg: "Nextcloud backup step failed on VM: {{ item.item }} (rc={{ item.rc }})" - name: Enable maintenance mode
success_msg: "All Nextcloud backup commands succeeded." command: docker exec -u www-data nextcloud php occ maintenance:mode --on
loop: "{{ nc_backup_cmds.results }}"
loop_control: - name: Create backup directory
index_var: idx file:
label: "backup-cmd-{{ idx }}" path: "{{ backup_dir }}"
state: directory
- name: Backup config and custom_apps
command: >
docker exec nextcloud
tar czf /tmp/nextcloud_conf.tgz -C /var/www/html config custom_apps
- name: Copy config backup out of container
command: docker cp nextcloud:/tmp/nextcloud_conf.tgz {{ backup_dir }}/
- name: Remove temp archive from container
command: docker exec nextcloud rm -f /tmp/nextcloud_conf.tgz
- name: Backup database
shell: >
docker exec nextcloud-db sh -c
'command -v mariadb-dump >/dev/null &&
mariadb-dump -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" "$MYSQL_DATABASE" ||
mysqldump -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" "$MYSQL_DATABASE"'
register: db_dump
- name: Save database dump
copy:
content: "{{ db_dump.stdout }}"
dest: "{{ backup_dir }}/db.sql"
# ------------------------- # -------------------------
# Upgrade phase # Upgrade
# ------------------------- # -------------------------
- name: Pull new Nextcloud image
command: docker compose -p {{ nextcloud_project }} -f {{ compose_file }} pull nextcloud
- name: Nextcloud | Run upgrade commands on VM (via SSH) - name: Recreate Nextcloud container
ansible.builtin.command: command: docker compose -p {{ nextcloud_project }} -f {{ compose_file }}
argv: up -d --no-deps --force-recreate nextcloud
- sshpass
- -e - name: Run Nextcloud upgrade
- ssh command: docker exec -u www-data nextcloud php occ upgrade
- -o
- StrictHostKeyChecking=no - name: Update apps
- -o command: docker exec -u www-data nextcloud php occ app:update --all
- ConnectTimeout=15
- "{{ vm_user }}@{{ vm_ip }}"
- bash
- -lc
- "{{ ('sudo ' if use_sudo else '') + item }}"
environment:
SSHPASS: "{{ vm_pass }}"
loop: "{{ nextcloud_upgrade_commands }}"
loop_control:
index_var: idx
label: "upgrade-cmd-{{ idx }}"
register: nc_upgrade_cmds
changed_when: false
failed_when: false failed_when: false
no_log: "{{ DEBUG == 0 }}"
- name: Nextcloud | Show outputs of upgrade commands (DEBUG) - name: Run maintenance repair
ansible.builtin.debug: command: docker exec -u www-data nextcloud php occ maintenance:repair --include-expensive
msg: | failed_when: false
CMD: {{ item.item }}
RC: {{ item.rc }}
STDOUT:
{{ (item.stdout | default('')).strip() }}
STDERR:
{{ (item.stderr | default('')).strip() }}
loop: "{{ nc_upgrade_cmds.results }}"
when: DEBUG == 1
- name: Nextcloud | Fail play if any upgrade command failed - name: Disable maintenance mode
ansible.builtin.assert: command: docker exec -u www-data nextcloud php occ maintenance:mode --off
that: "item.rc == 0"
fail_msg: "Nextcloud upgrade step failed on VM: {{ item.item }} (rc={{ item.rc }})"
success_msg: "All Nextcloud upgrade commands succeeded."
loop: "{{ nc_upgrade_cmds.results }}"
loop_control:
index_var: idx
label: "upgrade-cmd-{{ idx }}"
- name: Nextcloud | Disable maintenance mode (only after successful upgrade)
ansible.builtin.command:
argv:
- sshpass
- -e
- ssh
- -o
- StrictHostKeyChecking=no
- -o
- ConnectTimeout=15
- "{{ vm_user }}@{{ vm_ip }}"
- "{{ ('sudo ' if use_sudo else '') }}docker exec -u www-data nextcloud php occ maintenance:mode --off"
environment:
SSHPASS: "{{ vm_pass }}"
register: nc_maint_off
changed_when: false
no_log: "{{ DEBUG == 0 }}"
# ------------------------- # -------------------------
# Readiness check (status.php) # Readiness check
# ------------------------- # -------------------------
- name: Wait for status.php
- name: Nextcloud | Wait for status.php (controller first) uri:
ansible.builtin.uri:
url: "{{ nextcloud_status_url }}" url: "{{ nextcloud_status_url }}"
method: GET status_code: 200
return_content: true return_content: true
validate_certs: true validate_certs: true
status_code: 200 register: nc_status
register: nc_status_controller
delegate_to: localhost
run_once: true
retries: "{{ RETRIES }}" retries: "{{ RETRIES }}"
delay: 4 delay: 4
until: nc_status_controller.status == 200 until: nc_status.status == 200
failed_when: false
changed_when: false changed_when: false
- name: Nextcloud | VM-side fetch status.php (JSON via Python) - name: Print status summary (DEBUG)
ansible.builtin.command: debug:
argv: msg: >
- sshpass Nextcloud {{ nc_status.json.version }}
- -e (installed={{ nc_status.json.installed }},
- ssh maintenance={{ nc_status.json.maintenance }},
- -o needsDbUpgrade={{ nc_status.json.needsDbUpgrade }})
- StrictHostKeyChecking=no when: DEBUG == 1
- -o
- ConnectTimeout=15
- "{{ vm_user }}@{{ vm_ip }}"
- bash
- -lc
- |
python3 - <<'PY'
import json, urllib.request, sys
try:
with urllib.request.urlopen("{{ nextcloud_status_url }}", timeout=15) as r:
sys.stdout.write(r.read().decode())
except Exception:
pass
PY
environment:
SSHPASS: "{{ vm_pass }}"
register: nc_status_vm
changed_when: false
failed_when: false
when: nc_status_controller.status | default(0) != 200 or nc_status_controller.json is not defined
no_log: "{{ DEBUG == 0 }}"
- name: Nextcloud | Choose status JSON (controller wins, else VM)
ansible.builtin.set_fact:
nextcloud_status_json: >-
{{
(nc_status_controller.json
if (nc_status_controller.status | default(0)) == 200 and (nc_status_controller.json is defined)
else (
(nc_status_vm.stdout | default('') | trim | length > 0)
| ternary((nc_status_vm.stdout | trim | from_json), omit)
)
)
}}
failed_when: false
- name: Nextcloud | Print concise status summary (DEBUG)
ansible.builtin.debug:
msg: >-
Nextcloud {{ nextcloud_status_json.version | default('?') }}
(installed={{ nextcloud_status_json.installed | default('?') }},
maintenance={{ nextcloud_status_json.maintenance | default('?') }},
needsDbUpgrade={{ nextcloud_status_json.needsDbUpgrade | default('?') }})
when: nextcloud_status_json is defined and DEBUG == 1
- name: Nextcloud | Status JSON not available (DEBUG)
ansible.builtin.debug:
msg: "status.php is not reachable or did not return JSON."
when: nextcloud_status_json is not defined and DEBUG == 1