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

Inconsistency in README information about configuration

    XMLWordPrintable

    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: