<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
"http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head><meta http-equiv="content-type" content="text/html; charset=utf-8" />
<title>[59492] trunk/.github/workflows: Build/Test Tools: Introduce workflow for testing the local Docker environment.</title>
</head>
<body>
<style type="text/css"><!--
#msg dl.meta { border: 1px #006 solid; background: #369; padding: 6px; color: #fff; }
#msg dl.meta dt { float: left; width: 6em; font-weight: bold; }
#msg dt:after { content:':';}
#msg dl, #msg dt, #msg ul, #msg li, #header, #footer, #logmsg { font-family: verdana,arial,helvetica,sans-serif; font-size: 10pt; }
#msg dl a { font-weight: bold}
#msg dl a:link { color:#fc3; }
#msg dl a:active { color:#ff0; }
#msg dl a:visited { color:#cc6; }
h3 { font-family: verdana,arial,helvetica,sans-serif; font-size: 10pt; font-weight: bold; }
#msg pre { white-space: pre-line; overflow: auto; background: #ffc; border: 1px #fa0 solid; padding: 6px; }
#logmsg { background: #ffc; border: 1px #fa0 solid; padding: 1em 1em 0 1em; }
#logmsg p, #logmsg pre, #logmsg blockquote { margin: 0 0 1em 0; }
#logmsg p, #logmsg li, #logmsg dt, #logmsg dd { line-height: 14pt; }
#logmsg h1, #logmsg h2, #logmsg h3, #logmsg h4, #logmsg h5, #logmsg h6 { margin: .5em 0; }
#logmsg h1:first-child, #logmsg h2:first-child, #logmsg h3:first-child, #logmsg h4:first-child, #logmsg h5:first-child, #logmsg h6:first-child { margin-top: 0; }
#logmsg ul, #logmsg ol { padding: 0; list-style-position: inside; margin: 0 0 0 1em; }
#logmsg ul { text-indent: -1em; padding-left: 1em; }#logmsg ol { text-indent: -1.5em; padding-left: 1.5em; }
#logmsg > ul, #logmsg > ol { margin: 0 0 1em 0; }
#logmsg pre { background: #eee; padding: 1em; }
#logmsg blockquote { border: 1px solid #fa0; border-left-width: 10px; padding: 1em 1em 0 1em; background: white;}
#logmsg dl { margin: 0; }
#logmsg dt { font-weight: bold; }
#logmsg dd { margin: 0; padding: 0 0 0.5em 0; }
#logmsg dd:before { content:'\00bb';}
#logmsg table { border-spacing: 0px; border-collapse: collapse; border-top: 4px solid #fa0; border-bottom: 1px solid #fa0; background: #fff; }
#logmsg table th { text-align: left; font-weight: normal; padding: 0.2em 0.5em; border-top: 1px dotted #fa0; }
#logmsg table td { text-align: right; border-top: 1px dotted #fa0; padding: 0.2em 0.5em; }
#logmsg table thead th { text-align: center; border-bottom: 1px solid #fa0; }
#logmsg table th.Corner { text-align: left; }
#logmsg hr { border: none 0; border-top: 2px dashed #fa0; height: 1px; }
#header, #footer { color: #fff; background: #636; border: 1px #300 solid; padding: 6px; }
#patch { width: 100%; }
#patch h4 {font-family: verdana,arial,helvetica,sans-serif;font-size:10pt;padding:8px;background:#369;color:#fff;margin:0;}
#patch .propset h4, #patch .binary h4 {margin:0;}
#patch pre {padding:0;line-height:1.2em;margin:0;}
#patch .diff {width:100%;background:#eee;padding: 0 0 10px 0;overflow:auto;}
#patch .propset .diff, #patch .binary .diff {padding:10px 0;}
#patch span {display:block;padding:0 10px;}
#patch .modfile, #patch .addfile, #patch .delfile, #patch .propset, #patch .binary, #patch .copfile {border:1px solid #ccc;margin:10px 0;}
#patch ins {background:#dfd;text-decoration:none;display:block;padding:0 10px;}
#patch del {background:#fdd;text-decoration:none;display:block;padding:0 10px;}
#patch .lines, .info {color:#888;background:#fff;}
--></style>
<div id="msg">
<dl class="meta" style="font-size: 105%">
<dt style="float: left; width: 6em; font-weight: bold">Revision</dt> <dd><a style="font-weight: bold" href="https://core.trac.wordpress.org/changeset/59492">59492</a><script type="application/ld+json">{"@context":"http://schema.org","@type":"EmailMessage","description":"Review this Commit","action":{"@type":"ViewAction","url":"https://core.trac.wordpress.org/changeset/59492","name":"Review Commit"}}</script></dd>
<dt style="float: left; width: 6em; font-weight: bold">Author</dt> <dd>desrosj</dd>
<dt style="float: left; width: 6em; font-weight: bold">Date</dt> <dd>2024-12-05 18:32:31 +0000 (Thu, 05 Dec 2024)</dd>
</dl>
<pre style='padding-left: 1em; margin: 2em 0; border-left: 2px solid #ccc; line-height: 1.25; font-size: 105%; font-family: sans-serif'>Build/Test Tools: Introduce workflow for testing the local Docker environment.
While the PHPUnit workflow currently relies on the local Docker environment and provides some safety checks that the environment works as expected, this may not always be true and does not test all of the available commands related to the environment.
This introduces a basic workflow for testing the related scripts for the various supported combinations of PHP and database software with the environment to confirm everything is working as expected.
Ideally this would also be run on Windows and MacOS to catch platform specific bugs. Unfortunately, Docker is not supported within the GitHub Action runner images, so not all bugs will be caught by this workflow.
Props johnbillion, Clorith.
See <a href="https://core.trac.wordpress.org/ticket/62221">#62221</a>.</pre>
<h3>Added Paths</h3>
<ul>
<li><a href="#trunkgithubworkflowslocaldockerenvironmentyml">trunk/.github/workflows/local-docker-environment.yml</a></li>
<li><a href="#trunkgithubworkflowsreusabletestlocaldockerenvironmentv1yml">trunk/.github/workflows/reusable-test-local-docker-environment-v1.yml</a></li>
</ul>
</div>
<div id="patch">
<h3>Diff</h3>
<a id="trunkgithubworkflowslocaldockerenvironmentyml"></a>
<div class="addfile"><h4 style="background-color: #eee; color: inherit; margin: 1em 0; padding: 1.3em; font-size: 115%">Added: trunk/.github/workflows/local-docker-environment.yml</h4>
<pre class="diff"><span>
<span class="info" style="display: block; padding: 0 10px; color: #888">--- trunk/.github/workflows/local-docker-environment.yml (rev 0)
+++ trunk/.github/workflows/local-docker-environment.yml 2024-12-05 18:32:31 UTC (rev 59492)
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -0,0 +1,154 @@
</span><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+name: Local Docker Environment
+
+on:
+ push:
+ branches:
+ - trunk
+ - '6.[8-9]'
+ - '[7-9].[0-9]'
+ paths:
+ # Any changes to Docker related files.
+ - '.env.example'
+ - 'docker-compose.yml'
+ # Any changes to local environment related files
+ - 'tools/local-env/**'
+ # These files manage packages used by the local environment.
+ - 'package*.json'
+ # These files configure Composer. Changes could affect the local environment.
+ - 'composer.*'
+ # These files define the versions to test.
+ - '.version-support-*.json'
+ # Changes to this and related workflow files should always be verified.
+ - '.github/workflows/local-docker-environment.yml'
+ - '.github/workflows/reusable-support-json-reader-v1.yml'
+ - '.github/workflows/reusable-test-docker-environment-v1.yml'
+ pull_request:
+ branches:
+ - trunk
+ - '6.[8-9]'
+ - '[7-9].[0-9]'
+ paths:
+ # Any changes to Docker related files.
+ - '.env.example'
+ - 'docker-compose.yml'
+ # Any changes to local environment related files
+ - 'tools/local-env/**'
+ # These files manage packages used by the local environment.
+ - 'package*.json'
+ # These files configure Composer. Changes could affect the local environment.
+ - 'composer.*'
+ # These files define the versions to test.
+ - '.version-support-*.json'
+ # Changes to this and related workflow files should always be verified.
+ - '.github/workflows/local-docker-environment.yml'
+ - '.github/workflows/reusable-support-json-reader-v1.yml'
+ - '.github/workflows/reusable-test-docker-environment-v1.yml'
+ workflow_dispatch:
+
+# Cancels all previous workflow runs for pull requests that have not completed.
+concurrency:
+ # The concurrency group contains the workflow name and the branch name for pull requests
+ # or the commit hash for any other events.
+ group: ${{ github.workflow }}-${{ github.event_name == 'pull_request' && github.head_ref || github.sha }}
+ cancel-in-progress: true
+
+# Disable permissions for all available scopes by default.
+# Any needed permissions should be configured at the job level.
+permissions: {}
+
+jobs:
+ #
+ # Determines the appropriate supported values for PHP and database versions based on the WordPress
+ # version being tested.
+ #
+ build-test-matrix:
+ name: Build Test Matrix
+ uses: WordPress/wordpress-develop/.github/workflows/reusable-support-json-reader-v1.yml@trunk
+ permissions:
+ contents: read
+ secrets: inherit
+ if: ${{ github.repository == 'WordPress/wordpress-develop' || github.event_name == 'pull_request' }}
+ with:
+ wp-version: ${{ github.event_name == 'pull_request' && github.base_ref || github.ref_name }}
+
+ # Tests the local Docker environment.
+ environment-tests-mysql:
+ name: PHP ${{ matrix.php }}
+ uses: WordPress/wordpress-develop/.github/workflows/reusable-test-local-docker-environment-v1.yml@trunk
+ permissions:
+ contents: read
+ if: ${{ github.repository == 'WordPress/wordpress-develop' || github.event_name == 'pull_request' }}
+ needs: [ build-test-matrix ]
+ strategy:
+ fail-fast: false
+ matrix:
+ os: [ ubuntu-latest ]
+ memcached: [ false, true ]
+ php: ${{ fromJSON( needs.build-test-matrix.outputs.php-versions ) }}
+ db-version: ${{ fromJSON( needs.build-test-matrix.outputs.mysql-versions ) }}
+
+ exclude:
+ # The MySQL 5.5 containers will not start.
+ - db-version: '5.5'
+ # MySQL 9.0+ will not work on PHP 7.2 & 7.3
+ - php: '7.2'
+ db-version: '9.0'
+ - php: '7.3'
+ db-version: '9.0'
+
+ with:
+ os: ${{ matrix.os }}
+ php: ${{ matrix.php }}
+ db-type: 'mysql'
+ db-version: ${{ matrix.db-version }}
+ memcached: ${{ matrix.memcached }}
+ tests-domain: ${{ matrix.tests-domain }}
+
+ slack-notifications:
+ name: Slack Notifications
+ uses: WordPress/wordpress-develop/.github/workflows/slack-notifications.yml@trunk
+ permissions:
+ actions: read
+ contents: read
+ needs: [ build-test-matrix, environment-tests-mysql ]
+ if: ${{ github.repository == 'WordPress/wordpress-develop' && github.event_name != 'pull_request' && always() }}
+ with:
+ calling_status: ${{ contains( needs.*.result, 'cancelled' ) && 'cancelled' || contains( needs.*.result, 'failure' ) && 'failure' || 'success' }}
+ secrets:
+ SLACK_GHA_SUCCESS_WEBHOOK: ${{ secrets.SLACK_GHA_SUCCESS_WEBHOOK }}
+ SLACK_GHA_CANCELLED_WEBHOOK: ${{ secrets.SLACK_GHA_CANCELLED_WEBHOOK }}
+ SLACK_GHA_FIXED_WEBHOOK: ${{ secrets.SLACK_GHA_FIXED_WEBHOOK }}
+ SLACK_GHA_FAILURE_WEBHOOK: ${{ secrets.SLACK_GHA_FAILURE_WEBHOOK }}
+
+ failed-workflow:
+ name: Failed workflow tasks
+ runs-on: ubuntu-latest
+ permissions:
+ actions: write
+ needs: [ build-test-matrix, environment-tests-mysql, slack-notifications ]
+ if: |
+ always() &&
+ github.repository == 'WordPress/wordpress-develop' &&
+ github.event_name != 'pull_request' &&
+ github.run_attempt < 2 &&
+ (
+ contains( needs.*.result, 'cancelled' ) ||
+ contains( needs.*.result, 'failure' )
+ )
+
+ steps:
+ - name: Dispatch workflow run
+ uses: actions/github-script@60a0d83039c74a4aee543508d2ffcb1c3799cdea # v7.0.1
+ with:
+ retries: 2
+ retry-exempt-status-codes: 418
+ script: |
+ github.rest.actions.createWorkflowDispatch({
+ owner: context.repo.owner,
+ repo: context.repo.repo,
+ workflow_id: 'failed-workflow.yml',
+ ref: 'trunk',
+ inputs: {
+ run_id: '${{ github.run_id }}'
+ }
+ });
</ins></span></pre></div>
<a id="trunkgithubworkflowsreusabletestlocaldockerenvironmentv1yml"></a>
<div class="addfile"><h4 style="background-color: #eee; color: inherit; margin: 1em 0; padding: 1.3em; font-size: 115%">Added: trunk/.github/workflows/reusable-test-local-docker-environment-v1.yml</h4>
<pre class="diff"><span>
<span class="info" style="display: block; padding: 0 10px; color: #888">--- trunk/.github/workflows/reusable-test-local-docker-environment-v1.yml (rev 0)
+++ trunk/.github/workflows/reusable-test-local-docker-environment-v1.yml 2024-12-05 18:32:31 UTC (rev 59492)
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -0,0 +1,160 @@
</span><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+##
+# A reusable workflow that ensures the local Docker environment is working properly.
+#
+# This workflow is used by `trunk` and branches >= 6.8.
+##
+name: Test local Docker environment
+
+on:
+ workflow_call:
+ inputs:
+ os:
+ description: 'Operating system to test'
+ required: false
+ type: 'string'
+ default: 'ubuntu-latest'
+ php:
+ description: 'The version of PHP to use, in the format of X.Y'
+ required: false
+ type: 'string'
+ default: 'latest'
+ db-type:
+ description: 'Database type. Valid types are mysql and mariadb'
+ required: false
+ type: 'string'
+ default: 'mysql'
+ db-version:
+ description: 'Database version'
+ required: false
+ type: 'string'
+ default: '8.0'
+ memcached:
+ description: 'Whether to enable memcached'
+ required: false
+ type: 'boolean'
+ default: false
+ tests-domain:
+ description: 'The domain to use for the tests'
+ required: false
+ type: 'string'
+ default: 'example.org'
+
+env:
+ LOCAL_PHP: ${{ inputs.php == 'latest' && 'latest' || format( '{0}-fpm', inputs.php ) }}
+ LOCAL_DB_TYPE: ${{ inputs.db-type }}
+ LOCAL_DB_VERSION: ${{ inputs.db-version }}
+ LOCAL_PHP_MEMCACHED: ${{ inputs.memcached }}
+ LOCAL_WP_TESTS_DOMAIN: ${{ inputs.tests-domain }}
+ PUPPETEER_SKIP_DOWNLOAD: ${{ true }}
+
+jobs:
+ # Tests the local Docker environment.
+ #
+ # Performs the following steps:
+ # - Sets environment variables.
+ # - Checks out the repository.
+ # - Sets up Node.js.
+ # - Sets up PHP.
+ # - Installs Composer dependencies.
+ # - Installs npm dependencies
+ # - Logs general debug information about the runner.
+ # - Logs Docker debug information (about the Docker installation within the runner).
+ # - Starts the WordPress Docker container.
+ # - Logs the running Docker containers.
+ # - Logs debug information about what's installed within the WordPress Docker containers.
+ # - Install WordPress within the Docker container.
+ # - Restarts the Docker environment.
+ # - Runs a WP CLI command.
+ # - Tests the logs command.
+ # - Tests the reset command.
+ # - Ensures version-controlled files are not modified or deleted.
+ local-docker-environment-tests:
+ name: PHP ${{ inputs.php }} / ${{ 'mariadb' == inputs.db-type && 'MariaDB' || 'MySQL' }} ${{ inputs.db-version }}${{ inputs.memcached && ' with memcached' || '' }}${{ 'example.org' != inputs.tests-domain && format( ' {0}', inputs.tests-domain ) || '' }}
+ runs-on: ${{ inputs.os }}
+ timeout-minutes: 20
+
+ steps:
+ - name: Configure environment variables
+ run: |
+ echo "PHP_FPM_UID=$(id -u)" >> $GITHUB_ENV
+ echo "PHP_FPM_GID=$(id -g)" >> $GITHUB_ENV
+
+ - name: Checkout repository
+ uses: actions/checkout@b4ffde65f46336ab88eb53be808477a3936bae11 # v4.1.1
+ with:
+ show-progress: ${{ runner.debug == '1' && 'true' || 'false' }}
+
+ - name: Set up Node.js
+ uses: actions/setup-node@1e60f620b9541d16bece96c5465dc8ee9832be0b # v4.0.3
+ with:
+ node-version-file: '.nvmrc'
+ cache: npm
+
+ ##
+ # This allows Composer dependencies to be installed using a single step.
+ #
+ # Since tests are currently run within the Docker containers where the PHP version varies,
+ # the same PHP version needs to be configured for the action runner machine so that the correct
+ # dependency versions are installed and cached.
+ ##
+ - name: Set up PHP
+ uses: shivammathur/setup-php@c541c155eee45413f5b09a52248675b1a2575231 # v2.31.1
+ with:
+ php-version: '${{ inputs.php }}'
+ coverage: none
+
+ # Since Composer dependencies are installed using `composer update` and no lock file is in version control,
+ # passing a custom cache suffix ensures that the cache is flushed at least once per week.
+ - name: Install Composer dependencies
+ uses: ramsey/composer-install@57532f8be5bda426838819c5ee9afb8af389d51a # v3.0.0
+ with:
+ custom-cache-suffix: $(/bin/date -u --date='last Mon' "+%F")
+
+ - name: Install npm dependencies
+ run: npm ci
+
+ - name: General debug information
+ run: |
+ npm --version
+ node --version
+ curl --version
+ git --version
+ composer --version
+ locale -a
+
+ - name: Docker debug information
+ run: |
+ docker -v
+
+ - name: Start Docker environment
+ run: |
+ npm run env:start
+
+ - name: Log running Docker containers
+ run: docker ps -a
+
+ - name: WordPress Docker container debug information
+ run: |
+ docker compose run --rm mysql ${{ env.LOCAL_DB_TYPE }} --version
+ docker compose run --rm php php --version
+ docker compose run --rm php php -m
+ docker compose run --rm php php -i
+ docker compose run --rm php locale -a
+
+ - name: Install WordPress
+ run: npm run env:install
+
+ - name: Restart Docker environment
+ run: npm run env:restart
+
+ - name: Test a CLI command
+ run: npm run env:cli wp option get siteurl
+
+ - name: Test logs command
+ run: npm run env:logs
+
+ - name: Reset the Docker environment
+ run: npm run env:reset
+
+ - name: Ensure version-controlled files are not modified or deleted
+ run: git diff --exit-code
</ins></span></pre>
</div>
</div>
</body>
</html>