Maxamillion (talk | contribs) m (Maxamillion moved page Talk:PackagingDrafts/Containers to Talk:Container:Guidelines: Moving this out of Draft Guidelines section of the Wiki.) |
(→DESCRIPTION of container: new section) |
||
Line 15: | Line 15: | ||
We do, it's still in Draft and needs some clean up. https://fedoraproject.org/wiki/PackagingDrafts/Package_Review_Process_with_Containers | We do, it's still in Draft and needs some clean up. https://fedoraproject.org/wiki/PackagingDrafts/Package_Review_Process_with_Containers | ||
[[User:Maxamillion|Maxamillion]] ([[User talk:Maxamillion|talk]]) 20:50, 18 October 2016 (UTC) | [[User:Maxamillion|Maxamillion]] ([[User talk:Maxamillion|talk]]) 20:50, 18 October 2016 (UTC) | ||
== DESCRIPTION of container == | |||
== DESCRIPTION == | |||
The container MUST have a file next to the Dockerfile called README. | |||
This file MUST contain the following: | |||
A brief description of what service/software the container has | |||
A brief example line of running the container | |||
If it is possible to configure the contained service the file MUST contain directions on how to do so. | |||
If the container has any dependencies on other services (for example a database) the file MUST detail these. | |||
If the container uses any volumes the file MUST detail what each one is for, see VOLUMES guidelines for more detail. | |||
The Dockerfile MUST have a label HELP which can either be a couple of lines detailing how to run the container or in the case of a more complex container with dependencies MUST be the URL to the README file (and once approved this should point to the README in dist-git. | |||
The Dockerfile MUST copy the README to /README in the container so that it is available locally after the container is pulled. |
Revision as of 10:45, 13 March 2017
Do we have docs that correspond to the list of links at the top of https://fedoraproject.org/wiki/Package_maintenance_guide? That is,
Learning to create packages Becoming a package maintainer Submitting package updates Adding a new package to the repository as an existing maintainer adding a new release branch to an existing package
?
Mattdm (talk) 14:55, 14 October 2016 (UTC)
We do, it's still in Draft and needs some clean up. https://fedoraproject.org/wiki/PackagingDrafts/Package_Review_Process_with_Containers Maxamillion (talk) 20:50, 18 October 2016 (UTC)
DESCRIPTION of container
DESCRIPTION
The container MUST have a file next to the Dockerfile called README.
This file MUST contain the following:
A brief description of what service/software the container has A brief example line of running the container
If it is possible to configure the contained service the file MUST contain directions on how to do so.
If the container has any dependencies on other services (for example a database) the file MUST detail these.
If the container uses any volumes the file MUST detail what each one is for, see VOLUMES guidelines for more detail.
The Dockerfile MUST have a label HELP which can either be a couple of lines detailing how to run the container or in the case of a more complex container with dependencies MUST be the URL to the README file (and once approved this should point to the README in dist-git.
The Dockerfile MUST copy the README to /README in the container so that it is available locally after the container is pulled.