simcop2387/docker-perl
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages 2 Wiki Activity

Update README.md

Browse source 
Now mention Docker Perl on architectures other than amd64, as well as
provide instructions for regenerating the Dockerfiles.
This commit is contained in:
Zak B. Elep 2017-12-04 10:55:20 +08:00
parent 7f1f1a3b17
commit 717a26014d
1 changed files with 30 additions and 18 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

48
README.md
View file

@ -1,27 +1,39 @@
docker-perl docker-perl
=========== ===========
Dockerfiles for Perl5 This project is the source for the Docker perl repo; for more details,
take a look at https://registry.hub.docker.com/_/perl/.
This project is the source for the Docker perl repo; for more details, take The structure of this repo is to use the full version ID of each Perl
a look at https://registry.hub.docker.com/_/perl/. version, plus a comma separate list of extensions. Every directory is
expected to have at least the bit specification (32bit or 64bit), and at
the moment the only other extension is threaded.
The structure of this repo is to use the full version ID of each Perl version, Despite having a directory layout expressed in terms of bit
plus a comma separate list of extensions. Every directory is expected to have specifications as above, the Docker Perl image now builds and runs in
at least the bit specification (32bit or 64bit), and at the moment the only architectures other than `amd64`, such as [`i386`][1] and
other extension is threaded. [`arm64v8`][2]; see [docker-library/official-images][3] for the details.
There are currently no 32bit extensions as Docker does not (yet?) support 32-bit
builds.
The 64bit builds specify use64bitall despite this being largely redundant [0]: https://hub.docker.com/r/i386/perl/
(Configure would properly detect this) to make the desired bit size explicit. [1]: https://hub.docker.com/r/arm64v8/perl
[2]: https://github.com/docker-library/official-images#architectures-other-than-amd64
The individual Dockerfiles are generated via 'generate.pl', which uses ## Getting Started
Releases.yaml to populate the individual files.
For older versions of Perl, some patches may be necessary to build properly on The individual Dockerfiles are generated via `generate.pl`, which uses
a current base OS. In those cases, perl -V will show the locally applied patches. Releases.yaml to populate the individual files. This needs the
These changes should be limited to Configure rather than to code itself, and `Devel::PatchPerl` and `YAML::XS` modules, which you can install by
will be a cherry pick or back port of a patch from the mainline perl branch doing `cpanm --installdeps .` in this repository's root directory.
whenever possible.
To regenerate the `Dockerfile`s, just run `./generate.pl`. Do note that
this might take time as it will download the Perl source tarballs for
each version to re-patch with updates from `Devel::PatchPerl` as needed.
Also, it is advised to update `Devel::PatchPerl` as soon as a new
version comes out.
For older versions of Perl, some patches may be necessary to build
properly on a current base OS. In those cases, perl -V will show the
locally applied patches. These changes should be limited to Configure
rather than to code itself, and will be a cherry pick or back port of a
patch from the mainline perl branch whenever possible.