Uploaded image for project: 'Percona Server for MySQL'
  1. Percona Server for MySQL
  2. PS-5877

Inconsistency in README information about configuration

    Details

    • Type: Admin & Maintenance Task
    • Status: Confirmation
    • Priority: Low
    • Resolution: Unresolved
    • Affects Version/s: None
    • Fix Version/s: None
    • Component/s: Documentation
    • Labels:

      Description

      First of all, it is a little confusing that both of the following exist, so not entirely sure if we maintain the docs as well as the images as they are in different orgs.

      The main README (docker-library) states that configuration of the MySQL instance should be done by overrides in the override dir:
      https://github.com/docker-library/docs/blame/master/percona/README.md#L140

      $ docker run --name some-percona -v /my/custom:/etc/mysql/conf.d -e MYSQL_ROOT_PASSWORD=my-secret-pw -d percona:tag

      Our docs suggest that this is not the case, e.g.
      https://github.com/percona/percona-docker/blame/master/percona-server.80/README.md#L148

      docker run --name my-new-container-name -v /my/custom/config-file:/etc/my.cnf -e MYSQL_ROOT_PASSWORD=my-secret-pw -d percona/percona-server:tag

      The README that appears on the hub for percona/percona-server adds yet another different recommendation:

      Using a Custom MySQL Config File

      The MySQL startup configuration in these Docker images is specified in the file /var/lib/mysql/my.cnf. If you want to customize this configuration for your own purposes, you can make changes to this file.

      At least for PS 8.0, you should probably be using /etc/my.cnf.d as it is configured for includes:

      (docker) => docker ps --filter name=percona_test-db_1
      CONTAINER ID        IMAGE               COMMAND                  CREATED             STATUS              PORTS                                NAMES
      e2d1fe42f30d        percona:8.0.15-6    "/opt/my-entrypoint.…"   43 seconds ago      Up 40 seconds       33060/tcp, 0.0.0.0:23306->3306/tcp   percona_test-db_1
       
      (docker) => docker exec percona_test-db_1 grep -F include /etc/my.cnf
      !includedir /etc/my.cnf.d
      

        Smart Checklist

          Attachments

            Activity

              People

              • Assignee:
                patrick.birch Patrick Birch
                Reporter:
                ceri.williams Ceri Williams
              • Votes:
                0 Vote for this issue
                Watchers:
                1 Start watching this issue

                Dates

                • Created:
                  Updated: