Docker: Difference between revisions
Content deleted Content added
m →Official image for simple development: environment spelling, use "environment" in header instead of image |
m Reverted edits by ~2026-35776-12 (talk) to last version by Douginamug Tag: Rollback |
||
| (32 intermediate revisions by 17 users not shown) | |||
| Line 1: | Line 1: | ||
'''Docker''' is |
'''Docker''' is virtualization software that allows administrators and developers to use "containers" to share environments containing software. These containers are isolated from other software running on the same computer. Docker {{ll|Comparison of distribution options|is one way to deploy and run MediaWiki}}. |
||
The [[Docker/SIG|Docker SIG]] is a Special Interest Group for people working with MediaWiki and related technologies on Docker. |
|||
== Official environment for simple development == |
== Official environment for simple development == |
||
'''{{ll|MediaWiki-Docker}}''' is an official development docker environment for MediaWiki that is included in MediaWiki itself, starting with MediaWiki 1.35. |
|||
This environment has been built for simple experimentation, development, and testing of proposed changes to MediaWiki core. It is designed to be particularly simple and easy to use, and intended particularly to be a good option for newbies, be they testers, designers, developers, or others who have not yet invested a great deal of their time in setting up local environments. |
This environment has been built for simple experimentation, development, and testing of proposed changes to MediaWiki core. It is designed to be particularly simple and easy to use, and intended particularly to be a good option for newbies, be they testers, designers, developers, or others who have not yet invested a great deal of their time in setting up local environments. |
||
| ⚫ | |||
To get started, please read the instructions, available inside the MediaWiki repo, at [[gerrit:plugins/gitiles/mediawiki/core/+/master/DEVELOPERS.md|<code>DEVELOPERS.md</code>]]. |
|||
As of May 2025, there are '''no official Docker images''' recommended for hosting a third party MediaWiki production instance. |
|||
If you run into any issues, please file a task at https://phabricator.wikimedia.org/tag/mediawiki-docker/. |
|||
== Official image for complex development == |
|||
We know that there are number of people who need a more complex, configurable, and powerful development and testing environment, even up to being a "Wikimedia production-like" state. The simple environment is not suitable for that use case; we plan to provide a more configurable and thus more complex, "heavy-weight" alternative for that use case in the future. You may wish to follow our work in Phabricator. https://phabricator.wikimedia.org/tag/local-charts/ |
|||
In the mean time, please see below. |
|||
| ⚫ | |||
It is likely that official MediaWiki releases will be made in Docker image form in the future, but these have not been committed to yet. |
|||
Wikimedia production will be moving to use Docker images as part of the "''Streamlined Services Delivery''" program for continuous deployment, [[toolforge:dockerregistry/wikimedia/wikimedia-production/tags/|early versions of which are published]], but these are bespoke and will not be useful for third parties. |
|||
In the mean time, please see below. |
|||
Wikimedia production is hosted using bespoke Docker images, but these are private (as they contain private settings and security controls) and so are not available (nor particularly useful) for third parties. See [[wikitech:MediaWiki_On_Kubernetes|MediaWiki on Kubernetes]] for more information. |
|||
== Other available images == |
|||
== Unofficial images for production == |
|||
There are a number of '''unofficial''' MediaWiki docker images. |
|||
{{Phabricator|T318977}} requests official images for third parties be produced and distributed, but until it is, all production docker deployments are currently '''unofficial''' and done at your '''own risk'''. |
|||
* There is regularly-updated [https://hub.docker.com/_/mediawiki Docker Hub MediaWiki repository] with images intended for production. More information at {{ll|Docker/Docker Hub}}. |
|||
In the mean time, there are several sources of other possible images shown below; you should use these at your own risk: |
|||
* The [[Canasta]] distribution is also structured as a Docker image. |
|||
* The initially-run-by-Docker "official" repository for MediaWiki is described at [[Docker/Hub]]; despite the label, '''these are not official''' and not supported. |
|||
* The [[MediaWiki-Docker-Dev]] project has builds |
|||
*https://github.com/niedzielski/boxwiki |
|||
*https://github.com/rlewkowicz/docker-mediawiki-stack/tree/REL1_28 |
|||
*https://github.com/pastakhov/compose-mediawiki-ubuntu (MediaWiki + Memcached + Parsoid + RESTBase + Elasticsearch + Vagrant). |
|||
== See also == |
== See also == |
||
* [https://www.docker.com Docker official site] |
|||
* [[w:Docker_(software)|Docker (software) article on Wikipedia]] |
* [[w:Docker_(software)|Docker (software) article on Wikipedia]] |
||
Latest revision as of 20:23, 18 June 2026
Docker is virtualization software that allows administrators and developers to use "containers" to share environments containing software. These containers are isolated from other software running on the same computer. Docker is one way to deploy and run MediaWiki.
Official environment for simple development
[edit | edit source]MediaWiki-Docker is an official development docker environment for MediaWiki that is included in MediaWiki itself, starting with MediaWiki 1.35.
This environment has been built for simple experimentation, development, and testing of proposed changes to MediaWiki core. It is designed to be particularly simple and easy to use, and intended particularly to be a good option for newbies, be they testers, designers, developers, or others who have not yet invested a great deal of their time in setting up local environments.
Official images for production
[edit | edit source]As of May 2025, there are no official Docker images recommended for hosting a third party MediaWiki production instance.
Wikimedia production is hosted using bespoke Docker images, but these are private (as they contain private settings and security controls) and so are not available (nor particularly useful) for third parties. See MediaWiki on Kubernetes for more information.
Unofficial images for production
[edit | edit source]T318977 requests official images for third parties be produced and distributed, but until it is, all production docker deployments are currently unofficial and done at your own risk.
- There is regularly-updated Docker Hub MediaWiki repository with images intended for production. More information at Docker/Docker Hub.
- The Canasta distribution is also structured as a Docker image.