xinfra/ansible/mysql-deploy.yml

---
- name: Native MySQL delivery
  hosts: "{{ target_hosts }}"
  become: true
  gather_facts: true
  any_errors_fatal: true
  vars:
    # --- identity ---
    mysql_instance: "{{ instance_name }}"
    mysql_version_value: "{{ mysql_version | default('8.0') }}"
    mysql_package_map:
      "8.0": "mysql-server=8.0.46-0ubuntu0.24.04.3"
    mysql_package_name: "{{ mysql_package_map[mysql_version_value] }}"

    # --- platform-allocated inputs (safe fallbacks when not passed in) ---
    # 端口池 13306–13999：平台从池分配并传入；未传时兜底池首端口，占用探测在目标机执行。
    mysql_port_value: "{{ mysql_port | default(13306) | int }}"
    # GR 组通信端口：仅 mgr_3 使用，平台成对分配；兜底为 SQL 端口 +10000。
    mysql_gr_port_value: "{{ gr_port | default((mysql_port | default(13306) | int) + 10000) | int }}"
    # 数据盘挂载点：平台按白名单选定并传入；兜底 /data。
    mysql_data_disk: "{{ data_disk | default('/data') }}"

    # --- resource quota (Go→AWX 契约单位保持 MB/GB，不擅改) ---
    mysql_memory_mb_value: "{{ memory_mb | default(4096) | int }}"
    mysql_storage_gb_value: "{{ storage_gb | default(50) | int }}"

    # --- mount-point-agnostic layout: {data_disk}/mysql-delivery/{instance_id}/... ---
    mysql_base_dir: "{{ mysql_data_disk }}/mysql-delivery/{{ mysql_instance }}"
    mysql_install_dir: "/opt/mysql-delivery/{{ mysql_instance }}"
    mysql_data_dir: "{{ mysql_base_dir }}/data"
    mysql_log_dir: "{{ mysql_base_dir }}/logs"
    mysql_binlog_dir: "{{ mysql_base_dir }}/logs/binlog"
    mysql_redo_dir: "{{ mysql_base_dir }}/logs/redo"
    mysql_tmp_dir: "{{ mysql_base_dir }}/tmp"
    # socket/pid 走 /run tmpfs（重启自动清理），由 systemd RuntimeDirectory 创建。
    mysql_run_dir: "/run/mysql-delivery-{{ mysql_instance }}"
    mysql_config_file: "/etc/mysql/mysql-delivery/{{ mysql_instance }}.cnf"

    # --- database config (user form, with doc default baselines) ---
    mysql_timezone: "{{ timezone | default('+08:00') }}"
    mysql_lower_case_table_names: "{{ lower_case_table_names | default(1) | int }}"
    mysql_character_set: "{{ character_set | default('utf8mb4') }}"
    mysql_collation: "{{ collation | default('utf8mb4_general_ci') }}"

    # --- advanced params (overridable; default baseline assumes SSD for io_capacity) ---
    mysql_flush_log_at_trx_commit: "{{ innodb_flush_log_at_trx_commit | default(1) | int }}"
    mysql_sync_binlog: "{{ sync_binlog | default(1) | int }}"
    mysql_io_capacity: "{{ innodb_io_capacity | default(2000) | int }}"
    mysql_long_query_time: "{{ long_query_time | default(1) }}"
    mysql_binlog_expire_logs_seconds: "{{ binlog_expire_logs_seconds | default(604800) | int }}"
    mysql_max_binlog_size: "{{ max_binlog_size | default('256M') }}"
    mgr_group_name: "{{ group_replication_group_name | default('aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa') }}"

    # --- expected node count per topology ---
    mysql_expected_hosts: "{{ {'standalone': 1, 'primary_replica': 2, 'mgr_3': 3}[topology | default('standalone')] }}"

    # --- secrets (injected via environment) ---
    mysql_root_password_value: "{{ lookup('ansible.builtin.env', 'XINFRA_MYSQL_ROOT_PASSWORD') }}"
    mysql_admin_password_value: "{{ lookup('ansible.builtin.env', 'XINFRA_MYSQL_ADMIN_PASSWORD') }}"

  pre_tasks:
    - name: Validate delivery parameters
      ansible.builtin.assert:
        that:
          - topology in ['standalone', 'primary_replica', 'mgr_3']
          - mysql_instance is match('^[a-z0-9][a-z0-9-]{0,62}$')
          - mysql_version_value in mysql_package_map
          - mysql_data_disk is match('^/')
          - (mysql_port_value | int) >= 13306
          - (mysql_port_value | int) <= 13999
          - (mysql_memory_mb_value | int) >= 2048
          - (mysql_memory_mb_value | int) <= 65536
          - (mysql_storage_gb_value | int) >= 20
          - (mysql_storage_gb_value | int) <= 2000
          - (mysql_lower_case_table_names | int) in [0, 1]
          - mysql_root_password_value | length >= 16
          - mysql_admin_password_value | length >= 16
        fail_msg: >-
          Delivery parameters out of the supported target-state whitelist
          (topology / version-package-map / port pool 13306-13999 / memory 2-64G / storage 20-2000G).
        quiet: true
      no_log: true

    - name: Validate topology host count
      ansible.builtin.assert:
        that:
          - (ansible_play_hosts_all | length | int) == (mysql_expected_hosts | int)
        fail_msg: "topology={{ topology }} expects {{ mysql_expected_hosts }} host(s), got {{ ansible_play_hosts_all | length }}"
      run_once: true

    - name: Probe target-host port occupancy (SQL + GR)
      ansible.builtin.shell: |
        set -o pipefail
        for p in {{ mysql_probe_ports | join(' ') }}; do
          if ss -lntH "sport = :${p}" | grep -q .; then
            # already listening: only tolerated when owned by this instance service
            if ! systemctl is-active --quiet "mysql-delivery@{{ mysql_instance }}.service"; then
              echo "port ${p} already in use on target host" >&2
              exit 3
            fi
          fi
        done
      args:
        executable: /bin/bash
      vars:
        mysql_probe_ports: "{{ [mysql_port_value, mysql_gr_port_value] if topology == 'mgr_3' else [mysql_port_value] }}"
      changed_when: false

    - name: Read currently available memory (point-in-time guard)
      ansible.builtin.shell: awk '/^MemAvailable:/ { print int($2 / 1024) }' /proc/meminfo
      args:
        executable: /bin/bash
      register: mysql_available_memory
      changed_when: false

    - name: Resolve data-disk mountpoint available space
      ansible.builtin.set_fact:
        mysql_mount_avail: >-
          {{ (ansible_mounts | selectattr('mount', 'equalto', mysql_data_disk)
              | map(attribute='size_available') | first)
             | default(ansible_mounts | selectattr('mount', 'equalto', '/')
              | map(attribute='size_available') | first) }}

    - name: Check available memory and data-disk space
      ansible.builtin.assert:
        that:
          - (mysql_available_memory.stdout | int) >= (mysql_memory_mb_value | int)
          - (mysql_mount_avail | int) >= (mysql_storage_gb_value | int) * 1073741824
        fail_msg: >-
          Target host lacks memory or free space on {{ mysql_data_disk }};
          host-wide Σ-quota budgeting is the platform's responsibility, this is a last-resort guard.

  tasks:
    - name: Detect an existing Ubuntu MySQL package
      ansible.builtin.command: dpkg-query -W mysql-server
      register: mysql_package_before
      failed_when: false
      changed_when: false

    - name: Install Ubuntu MySQL package
      ansible.builtin.apt:
        name: "{{ mysql_package_name }}"
        state: present
        update_cache: true
        cache_valid_time: 3600

    - name: Stop the automatically created default instance on a clean host
      ansible.builtin.systemd_service:
        name: mysql.service
        state: stopped
        enabled: false
      when: mysql_package_before.rc != 0

    - name: Check for the bundled MySQL AppArmor profile
      ansible.builtin.stat:
        path: /etc/apparmor.d/usr.sbin.mysqld
      register: mysql_apparmor_profile

    - name: Authorize the delivery paths in the MySQL AppArmor profile
      ansible.builtin.copy:
        dest: /etc/apparmor.d/local/usr.sbin.mysqld
        owner: root
        group: root
        mode: '0644'
        content: |
          # Managed by XINFRA MySQL delivery - grant per-instance native paths
          {{ mysql_data_disk }}/mysql-delivery/ r,
          {{ mysql_data_disk }}/mysql-delivery/** rwk,
          /run/mysql-delivery-*/ rw,
          /run/mysql-delivery-*/** rwk,
      when: mysql_apparmor_profile.stat.exists
      register: mysql_apparmor_local

    - name: Reload the MySQL AppArmor profile
      ansible.builtin.command: apparmor_parser -r /etc/apparmor.d/usr.sbin.mysqld
      when: mysql_apparmor_profile.stat.exists and mysql_apparmor_local.changed
      changed_when: true

    - name: Create instance directories (mount-point-agnostic layout)
      ansible.builtin.file:
        path: "{{ item.path }}"
        state: directory
        owner: "{{ item.owner }}"
        group: "{{ item.group }}"
        mode: "{{ item.mode }}"
      loop:
        - { path: /etc/mysql/mysql-delivery, owner: root, group: mysql, mode: '0750' }
        - { path: "{{ mysql_install_dir }}", owner: root, group: root, mode: '0755' }
        - { path: "{{ mysql_base_dir }}", owner: mysql, group: mysql, mode: '0750' }
        - { path: "{{ mysql_data_dir }}", owner: mysql, group: mysql, mode: '0750' }
        - { path: "{{ mysql_log_dir }}", owner: mysql, group: mysql, mode: '0750' }
        - { path: "{{ mysql_binlog_dir }}", owner: mysql, group: mysql, mode: '0750' }
        - { path: "{{ mysql_redo_dir }}", owner: mysql, group: mysql, mode: '0750' }
        - { path: "{{ mysql_tmp_dir }}", owner: mysql, group: mysql, mode: '0750' }

    - name: Link native binaries into the instance directory
      ansible.builtin.file:
        src: "{{ item.src }}"
        dest: "{{ mysql_install_dir }}/{{ item.dest }}"
        state: link
      loop:
        - { src: /usr/sbin/mysqld, dest: mysqld }
        - { src: /usr/bin/mysql, dest: mysql }
        - { src: /usr/bin/mysqladmin, dest: mysqladmin }

    - name: Calculate host role and server id
      ansible.builtin.set_fact:
        mysql_node_index: "{{ ansible_play_hosts_all.index(inventory_hostname) }}"
        mysql_node_role: >-
          {{ 'standalone' if topology == 'standalone' else
             ('primary' if ansible_play_hosts_all.index(inventory_hostname) == 0 else
             ('replica' if topology == 'primary_replica' else 'mgr')) }}
        # host-wide unique: platform may pass explicit mysql_server_id; otherwise derive
        # port + node index (ports are unique per host in the pool model).
        mysql_server_id_value: >-
          {{ mysql_server_id | default((mysql_port_value | int)
             + (ansible_play_hosts_all.index(inventory_hostname))) | int }}

    - name: Resolve memory tier (GB)
      ansible.builtin.set_fact:
        mysql_memory_gb: "{{ ((mysql_memory_mb_value | int) // 1024) | int }}"

    - name: Resolve linkage-derived defaults (illustrative tiers, pending hardware calibration)
      ansible.builtin.set_fact:
        mysql_max_connections: >-
          {{ (max_connections | int) if (max_connections is defined and (max_connections | string) != 'auto')
             else (200 if (mysql_memory_gb | int) <= 2
             else 500 if (mysql_memory_gb | int) <= 4
             else 1000 if (mysql_memory_gb | int) <= 8
             else 2000 if (mysql_memory_gb | int) <= 16
             else 4000 if (mysql_memory_gb | int) <= 32
             else 8000 if (mysql_memory_gb | int) <= 64
             else 16000) }}
        mysql_redo_capacity: >-
          {{ innodb_redo_log_capacity if (innodb_redo_log_capacity is defined)
             else ('128M' if (mysql_memory_gb | int) <= 4
             else '256M' if (mysql_memory_gb | int) <= 16
             else '512M' if (mysql_memory_gb | int) <= 32
             else '1G') }}

    - name: Write instance configuration
      ansible.builtin.template:
        src: templates/mysql-instance.cnf.j2
        dest: "{{ mysql_config_file }}"
        owner: root
        group: mysql
        mode: '0640'
      notify: Restart MySQL delivery instance

    - name: Initialize the data directory once
      ansible.builtin.command:
        argv:
          - /usr/sbin/mysqld
          - "--defaults-file={{ mysql_config_file }}"
          - --initialize-insecure
          - --user=mysql
      args:
        creates: "{{ mysql_data_dir }}/auto.cnf"
      no_log: true

    - name: Install the delivery systemd template
      ansible.builtin.copy:
        src: files/mysql-delivery@.service
        dest: /etc/systemd/system/mysql-delivery@.service
        owner: root
        group: root
        mode: '0644'
      register: mysql_systemd_unit

    - name: Reload systemd units
      ansible.builtin.systemd_service:
        daemon_reload: true
      when: mysql_systemd_unit.changed

    - name: Start the MySQL delivery instance
      ansible.builtin.systemd_service:
        name: "mysql-delivery@{{ mysql_instance }}.service"
        state: started
        enabled: true

    - name: Wait for the local MySQL socket
      ansible.builtin.wait_for:
        path: "{{ mysql_run_dir }}/mysql.sock"
        timeout: 60

    - name: Configure local administrative accounts
      ansible.builtin.shell: |
        set -euo pipefail
        client_file="$(mktemp)"
        sql_file="$(mktemp)"
        trap 'rm -f "$client_file" "$sql_file"' EXIT
        chmod 600 "$client_file" "$sql_file"
        cat >"$client_file" <<'EOF'
        [client]
        user=root
        password={{ mysql_root_password_value }}
        socket={{ mysql_run_dir }}/mysql.sock
        EOF
        if ! /usr/bin/mysql --defaults-extra-file="$client_file" -e 'SELECT 1' >/dev/null 2>&1; then
          cat >"$sql_file" <<'EOF'
        ALTER USER 'root'@'localhost' IDENTIFIED BY '{{ mysql_root_password_value | replace("'", "''") }}';
        EOF
          /usr/bin/mysql --protocol=socket --socket={{ mysql_run_dir }}/mysql.sock -uroot <"$sql_file"
        fi
        cat >"$sql_file" <<'EOF'
        CREATE USER IF NOT EXISTS 'xinfra_admin'@'%' IDENTIFIED BY '{{ mysql_admin_password_value | replace("'", "''") }}';
        ALTER USER 'xinfra_admin'@'%' IDENTIFIED BY '{{ mysql_admin_password_value | replace("'", "''") }}';
        GRANT ALL PRIVILEGES ON *.* TO 'xinfra_admin'@'%' WITH GRANT OPTION;
        FLUSH PRIVILEGES;
        EOF
        /usr/bin/mysql --defaults-extra-file="$client_file" <"$sql_file"
      args:
        executable: /bin/bash
      changed_when: false
      no_log: true

    - name: Verify MySQL TCP health
      ansible.builtin.wait_for:
        host: "{{ ansible_host | default(inventory_hostname) }}"
        port: "{{ mysql_port_value }}"
        timeout: 30

    - name: Note pending HA runtime orchestration
      ansible.builtin.debug:
        msg: >-
          topology={{ topology }} deployed with HA-ready config (GTID/binlog/relay/GR settings in place),
          but replication wiring (CHANGE REPLICATION SOURCE) and Group Replication bootstrap
          (START GROUP_REPLICATION) are not yet automated — nodes start config-ready only.
      when: topology != 'standalone'
      run_once: true

  handlers:
    - name: Restart MySQL delivery instance
      ansible.builtin.systemd_service:
        name: "mysql-delivery@{{ mysql_instance }}.service"
        state: restarted