Skip to content

Quarterly Maintenance: Upgrade Matomo and Premium Plugins and Set CPU Architecture - #40

Merged
cabutlermit merged 3 commits into
mainfrom
infra-656-maintenance
Aug 5, 2026
Merged

Quarterly Maintenance: Upgrade Matomo and Premium Plugins and Set CPU Architecture#40
cabutlermit merged 3 commits into
mainfrom
infra-656-maintenance

Conversation

@cabutlermit

@cabutlermit cabutlermit commented Aug 5, 2026

Copy link
Copy Markdown
Contributor

What does this PR do?

  • Update Matomo to the latest available version (v5.12.0)
  • Update the premium plugins to the latest available versions
  • Add an aws-architecture file to explicitly set the CPU Architecture for the container
  • Update the Makefile to use the architecture-specific dist-dev and public-dev commands that expect the .aws-architecture file

Helpful background context

  1. The Matomo upgrade from v5.10.1 to v5.12.0 does require a database upgrade after the new container launches. This has already been done in Dev1 and it was very quick with minimal changes.
  2. None of the plugin updates require any database changes.
  3. The CPU Architecture change must be tightly coupled with changes to the mitlib-tf-workloads-matomo infrastructure repository (see PR#39 on mitlib-tf-workloads-matomo](https://github.com/MITLibraries/mitlib-tf-workloads-matomo/pull/39)). Details follow.

The infrastructure changes related to CPU architecture must be deployed to the AWS Account immediately prior to the triggered GitHub Actions run from this repository. For Dev1, this was done manually via a commit to the dev branch on the infrastructure repository followed by a make publish-dev run from this repository.

For Stage-Workloads and Prod-Workloads, we will need to actively manage the opening of PRs and the merging of branches to ensure that this works smoothly. As a reminder,

  • opening a PR on this repository automatically builds and pushes a container to Dev1.
  • merging a PR on this repository automatically builds and pushes a container to Stage-Workloads (so we cannot merge this PR until after the Dev-to-Stage PR on mitlib-tf-workloads-matomo has been merged to the stage branch

How can a reviewer manually see the effects of these changes?

To see the changes, log in to the dev-matomo instance and verify the Matomo version and the versions of all of the plugins.

Includes new or updated dependencies?

YES: See PR#39 on mitlib-tf-workloads-matomo

What are the relevant tickets?

Developer

  • [n/a] All new ENV is documented in README (or there is none)
  • Stakeholder approval has been confirmed (or is not needed)

Code Reviewer

  • The commit message is clear and follows our guidelines
    (not just this pull request message)
  • There are appropriate tests covering any new functionality
  • The documentation has been updated or is unnecessary
  • The changes have been verified
  • New dependencies are appropriate or there were no changes

Why these changes are being made:
It's time for the quarterly maintenance on Matomo!

There is a new version of the Matomo Docker container (and it does
require a database upgrade after installation). There are also updates
to the premium plugins, but those will be in a separate commit.

How these changes are implemented:
* Update .gitignore
* Remove unnecessary .deb file
* Update Dockerfile to pull latest version of Matomo (5.12.0)

Related Jira tickets:
* https://mitlibraries.atlassian.net/browse/INFRA-656
Why these changes are being introduced:
With the upgrade to a newer version of Matomo, we always update
the versions of the free and premium plugins. There are no updates
to the free plugins, just the preimum plugins.

How these changes are implemented:
* Store the new unzipped plugin packages in this repository
* Update the Dockerfile to copy in the content from the new
versions of the plugins.

Related Jira tickets:
* https://mitlibraries.atlassian.net/browse/INFRA-656
Why these changes are being introduced:
As part of our planned maintenance for ECS-based applications, we are
explicitly declaring the CPU Architecture for the task. This update to
the application must be handled with tight coordination with changes to
the infrastructure repository. See commit b2903e88 on
mitlib-tf-workloads-matomo for the corresponding infrastructure update.

How this addresses that need:
* Add the .aws-architecture file to declare the CPU architecture
* Update .gitignore to ignore the .arch_tag file
* Update the Makefile with the new build and deploy commands for Dev1

Side effects of this change:
This must be done together with changes to the task definition. If not,
this will break the task.
@cabutlermit
cabutlermit marked this pull request as ready for review August 5, 2026 14:53
@cabutlermit
cabutlermit requested review from a team and dhrutibc as code owners August 5, 2026 14:53

@dhrutibc dhrutibc left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good - Matomo and all plugin versions are correct

@tim-rix tim-rix left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Everything looks OK to me.

I didn't review the plugin changes. Those files are expected to change and are from outside sources, not written for this repo.

@cabutlermit
cabutlermit merged commit c988640 into main Aug 5, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants