From a3112a617b7ab0b44496d1d68a08a23b96b97127 Mon Sep 17 00:00:00 2001 From: Weblate Date: Mar 29 2023 22:22:19 +0000 Subject: Update translation files Updated by "Update PO files to match POT (msgmerge)" hook in Weblate. Co-authored-by: Weblate Translate-URL: https://translate.fedoraproject.org/projects/fedora-docs-l10n-containers/masterpagesguidelinescreation/ Translation: fedora-docs-l10n/containers/master/pages/guidelines/creation --- diff --git a/po/fi/master/pages/guidelines/creation.po b/po/fi/master/pages/guidelines/creation.po index f2c9042..f3a9bab 100644 --- a/po/fi/master/pages/guidelines/creation.po +++ b/po/fi/master/pages/guidelines/creation.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" -"POT-Creation-Date: 2023-01-27 13:55+0000\n" +"POT-Creation-Date: 2023-03-29 22:15+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -16,118 +16,116 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" #. type: Title == -#: ./pages/guidelines/creation.adoc:2 +#: pages/guidelines/creation.adoc:2 #, no-wrap msgid "Container Image Creation" msgstr "" #. type: Plain text -#: ./pages/guidelines/creation.adoc:5 +#: pages/guidelines/creation.adoc:5 msgid "" -"Container images in Fedora are built using a " -"https://docs.docker.com/engine/reference/builder/[Dockerfile] much in the " -"same way an http://rpm.org/[RPM] is built using a spec file. In this section " -"are Fedora Guidelines for creating Container images using a Dockerfile." +"Container images in Fedora are built using a https://docs.docker.com/engine/" +"reference/builder/[Dockerfile] much in the same way an http://rpm.org/[RPM] " +"is built using a spec file. In this section are Fedora Guidelines for " +"creating Container images using a Dockerfile." msgstr "" #. type: Title === -#: ./pages/guidelines/creation.adoc:7 +#: pages/guidelines/creation.adoc:7 #, no-wrap msgid "Dockerfile Example" msgstr "" #. type: delimited block - -#: ./pages/guidelines/creation.adoc:11 ./pages/guidelines/creation.adoc:108 +#: pages/guidelines/creation.adoc:11 pages/guidelines/creation.adoc:108 #, no-wrap msgid "include::{examplesdir}/Dockerfile.example[]\n" msgstr "" #. type: Title === -#: ./pages/guidelines/creation.adoc:14 +#: pages/guidelines/creation.adoc:14 #, no-wrap msgid "FROM" msgstr "" #. type: Plain text -#: ./pages/guidelines/creation.adoc:16 +#: pages/guidelines/creation.adoc:16 msgid "" "As defined by the Dockerfile reference, the FROM instruction '''must''' be " -"the first line of a Dockerfile. The FROM instruction '''must''' be " -"fully-qualified with the fedora registry name, image name, and tag as shown " -"in this example:" +"the first line of a Dockerfile. The FROM instruction '''must''' be fully-" +"qualified with the fedora registry name, image name, and tag as shown in " +"this example:" msgstr "" #. type: Plain text -#: ./pages/guidelines/creation.adoc:20 +#: pages/guidelines/creation.adoc:20 msgid "``` FROM registry.fedoraproject.org/imagename:tag ```" msgstr "" #. type: Plain text -#: ./pages/guidelines/creation.adoc:22 +#: pages/guidelines/creation.adoc:22 msgid "" "This provides a guarantee of where the base image is coming from when being " "built by the build service or when rebuilt by a user." msgstr "" #. type: Plain text -#: ./pages/guidelines/creation.adoc:24 +#: pages/guidelines/creation.adoc:24 msgid "" -"For most layered images built by the " -"https://docs.pagure.org/releng/layered_image_build_service.html[Fedora " -"Layered Docker Image Build Service], the FROM line will use one of the " -"Fedora base images that exist on the " +"For most layered images built by the https://docs.pagure.org/releng/" +"layered_image_build_service.html[Fedora Layered Docker Image Build Service], " +"the FROM line will use one of the Fedora base images that exist on the " "https://registry.fedoraproject.org/[Fedora Container Registry]:" msgstr "" #. type: Plain text -#: ./pages/guidelines/creation.adoc:28 +#: pages/guidelines/creation.adoc:28 msgid "``` FROM registry.fedoraproject.org/fedora:latest ```" msgstr "" #. type: Plain text -#: ./pages/guidelines/creation.adoc:30 +#: pages/guidelines/creation.adoc:30 msgid "" "It is also possible to use another layered image as the base layer, as in " "this example:" msgstr "" #. type: Plain text -#: ./pages/guidelines/creation.adoc:34 +#: pages/guidelines/creation.adoc:34 msgid "``` FROM registry.fedoraproject.org/f25/kubernetes-master:latest ```" msgstr "" #. type: Title === -#: ./pages/guidelines/creation.adoc:36 +#: pages/guidelines/creation.adoc:36 #, no-wrap msgid "Labels" msgstr "" #. type: Plain text -#: ./pages/guidelines/creation.adoc:39 +#: pages/guidelines/creation.adoc:39 msgid "" -"Dockerfiles have a concept of a " -"https://docs.docker.com/engine/reference/builder/#label[LABEL] which can add " -"arbitrary metadata to an image as a key-value pair. Fedora Guidelines on the " -"topic of LABELs follows the http://www.projectatomic.io/[Project Atomic] " -"https://github.com/projectatomic/ContainerApplicationGenericLabels[Container " -"Application Generic Labels] standards for LABEL definition." +"Dockerfiles have a concept of a https://docs.docker.com/engine/reference/" +"builder/#label[LABEL] which can add arbitrary metadata to an image as a key-" +"value pair. Fedora Guidelines on the topic of LABELs follows the http://www." +"projectatomic.io/[Project Atomic] https://github.com/projectatomic/" +"ContainerApplicationGenericLabels[Container Application Generic Labels] " +"standards for LABEL definition." msgstr "" #. type: Plain text -#: ./pages/guidelines/creation.adoc:41 +#: pages/guidelines/creation.adoc:41 msgid "'''Required''' LABELs for a Fedora Layered Image are as follows:" msgstr "" #. type: Table -#: ./pages/guidelines/creation.adoc:67 +#: pages/guidelines/creation.adoc:67 #, no-wrap msgid "" "|Name\n" "|Description\n" "\n" "|com.redhat.component\n" -"|The Bugzilla component name where bugs against this container should be " -"reported by users.\n" +"|The Bugzilla component name where bugs against this container should be reported by users.\n" "\n" "|name\n" "|Name of the Image\n" @@ -136,27 +134,25 @@ msgid "" "|Version of the image\n" "\n" "|architecture\n" -"|Architecture the software in the image should target (Optional: if omitted, " -"it will be built for all supported Fedora Architectures)\n" +"|Architecture the software in the image should target (Optional: if omitted, it will be built for all supported Fedora Architectures)\n" "\n" "|maintainer\n" "|The name and email of the maintainer (usually the submitter)\n" "\n" "|run or usage\n" -"|Either provides an Atomic run line, or a human readable example of " -"container execution\n" +"|Either provides an Atomic run line, or a human readable example of container execution\n" "\n" "|summary\n" "|A short description of the image.\n" msgstr "" #. type: Plain text -#: ./pages/guidelines/creation.adoc:70 +#: pages/guidelines/creation.adoc:70 msgid "'''Optional''' labels for Fedora Layered Images" msgstr "" #. type: Table -#: ./pages/guidelines/creation.adoc:93 +#: pages/guidelines/creation.adoc:93 #, no-wrap msgid "" "|Name\n" @@ -178,33 +174,29 @@ msgid "" "|Used for system containers, see below.\n" "\n" "|Generics\n" -"|Any of the " -"https://github.com/projectatomic/ContainerApplicationGenericLabels[Container " -"Application Generic Labels] which are appropriate to the container, such as " -"\"stop\", \"debug\", or \"changelog-url\"\n" +"|Any of the https://github.com/projectatomic/ContainerApplicationGenericLabels[Container Application Generic Labels] which are appropriate to the container, such as \"stop\", \"debug\", or \"changelog-url\"\n" msgstr "" #. type: Plain text -#: ./pages/guidelines/creation.adoc:96 +#: pages/guidelines/creation.adoc:96 msgid "" "See LABEL SPECIFICATION below for more details on what's required for each " "of these labels." msgstr "" #. type: Plain text -#: ./pages/guidelines/creation.adoc:100 +#: pages/guidelines/creation.adoc:100 msgid "" "{{admon/note|Dockerfile Label Guidelines Upstream| The LABELs used here are " -"meant to be a Fedora adaptation of the upstream " -"https://projectatomic.io[Project Atomic] effort to define " -"https://github.com/projectatomic/ContainerApplicationGenericLabels[Container " -"Application Generic Labels] as well as " -"http://docs.projectatomic.io/container-best-practices/[Container Best " -"Practices]. }}" +"meant to be a Fedora adaptation of the upstream https://projectatomic." +"io[Project Atomic] effort to define https://github.com/projectatomic/" +"ContainerApplicationGenericLabels[Container Application Generic Labels] as " +"well as http://docs.projectatomic.io/container-best-practices/[Container " +"Best Practices]. }}" msgstr "" #. type: Plain text -#: ./pages/guidelines/creation.adoc:102 +#: pages/guidelines/creation.adoc:102 msgid "" "In the past these LABELs had to be defined in a single line of the " "Dockerfile so they would not lead to additional layers in the build. Recent " @@ -214,32 +206,32 @@ msgid "" msgstr "" #. type: Plain text -#: ./pages/guidelines/creation.adoc:104 +#: pages/guidelines/creation.adoc:104 msgid "" "The following is a very simple Dockerfile example containing the required " "LABELs:" msgstr "" #. type: Title === -#: ./pages/guidelines/creation.adoc:111 +#: pages/guidelines/creation.adoc:111 #, no-wrap msgid "LABEL SPECIFICATION" msgstr "" #. type: Plain text -#: ./pages/guidelines/creation.adoc:114 +#: pages/guidelines/creation.adoc:114 msgid "Some additional details about how each label is to be populated." msgstr "" #. type: Plain text -#: ./pages/guidelines/creation.adoc:116 +#: pages/guidelines/creation.adoc:116 msgid "" "'''com.redhat.component''': Existing Bugzilla component against which bugs " "in this image should be reported." msgstr "" #. type: Plain text -#: ./pages/guidelines/creation.adoc:118 +#: pages/guidelines/creation.adoc:118 msgid "" "'''name''': Name of the image. If the image replaces a standard RPM, it " "should have the exact same name of that RPM. Otherwise, please see naming " @@ -247,39 +239,37 @@ msgid "" msgstr "" #. type: Plain text -#: ./pages/guidelines/creation.adoc:120 +#: pages/guidelines/creation.adoc:120 msgid "" -"'''version''': Usually 0. Populated from the ENV variable. See " -"\"VERSIONING\" below for explanation." +"'''version''': Usually 0. Populated from the ARG variable. See \"VERSIONING" +"\" below for explanation." msgstr "" #. type: Plain text -#: ./pages/guidelines/creation.adoc:122 +#: pages/guidelines/creation.adoc:122 msgid "" "'''architecture''': usually \"x86_64\", unless the container image supports " "other/all architectures." msgstr "" #. type: Plain text -#: ./pages/guidelines/creation.adoc:124 +#: pages/guidelines/creation.adoc:124 msgid "" "'''usage''': a human-readable example command line for invoking the " "container. Required if run is not present. Should include all likely " -"options, such as ports, volumes, and any required command-line " -"parameters. You may use any container runtime as your example. Example from " -"the OwnCloud container:" +"options, such as ports, volumes, and any required command-line parameters. " +"You may use any container runtime as your example. Example from the OwnCloud " +"container:" msgstr "" #. type: Plain text -#: ./pages/guidelines/creation.adoc:126 +#: pages/guidelines/creation.adoc:126 #, no-wrap -msgid "" -" usage=\"docker run -d -P -v owncloud-data:/var/lib/owncloud -v " -"owncloud-config:/etc/owncloud owncloud\"\n" +msgid " usage=\"docker run -d -P -v owncloud-data:/var/lib/owncloud -v owncloud-config:/etc/owncloud owncloud\"\n" msgstr "" #. type: Plain text -#: ./pages/guidelines/creation.adoc:128 +#: pages/guidelines/creation.adoc:128 msgid "" "'''summary''': A short description of the image, intended to be searchable " "once we have a registry with search functionality. Please include relevant " @@ -287,7 +277,7 @@ msgid "" msgstr "" #. type: Plain text -#: ./pages/guidelines/creation.adoc:130 +#: pages/guidelines/creation.adoc:130 msgid "" "'''run''': a command line to invoke the container, suitable for use by the " "https://github.com/projectatomic/atomic[Atomic CLI], including placeholders " @@ -297,15 +287,13 @@ msgid "" msgstr "" #. type: Plain text -#: ./pages/guidelines/creation.adoc:132 +#: pages/guidelines/creation.adoc:132 #, no-wrap -msgid "" -" run=\"/usr/bin/docker run -d --privileged --pid=host -v /:/host IMAGE " -"/container/atomic-run --local-ssh\"\n" +msgid " run=\"/usr/bin/docker run -d --privileged --pid=host -v /:/host IMAGE /container/atomic-run --local-ssh\"\n" msgstr "" #. type: Plain text -#: ./pages/guidelines/creation.adoc:134 +#: pages/guidelines/creation.adoc:134 msgid "" "'''install''': A container may require preparation of the host system before " "the container can be run. In this case the install label is useful for " @@ -315,21 +303,19 @@ msgid "" "container. If an install label is provided then it must be tested and work " "with the https://github.com/projectatomic/atomic[Atomic CLI]. Optionally an " "uninstall label should also be provided that will allow for cleaning up any " -"operations done by install. Please refer to the " -"https://github.com/projectatomic/atomic#atomic-install[upstream " -"documentation] for more information. Example for the Cockpit container:" +"operations done by install. Please refer to the https://github.com/" +"projectatomic/atomic#atomic-install[upstream documentation] for more " +"information. Example for the Cockpit container:" msgstr "" #. type: Plain text -#: ./pages/guidelines/creation.adoc:136 +#: pages/guidelines/creation.adoc:136 #, no-wrap -msgid "" -" install=\"/usr/bin/docker run --rm --privileged -v /:/host IMAGE " -"/container/atomic-install\"\n" +msgid " install=\"/usr/bin/docker run --rm --privileged -v /:/host IMAGE /container/atomic-install\"\n" msgstr "" #. type: Plain text -#: ./pages/guidelines/creation.adoc:138 +#: pages/guidelines/creation.adoc:138 msgid "" "'''uninstall''': If a container has an install label then most likely an " "uninstall label will be needed in order to delete any files and/or to clean " @@ -338,28 +324,25 @@ msgid "" "files or configuration to clean up from the install label so the uninstall " "label might not be needed. If an uninstall label is provided then it must be " "tested and work with the https://github.com/projectatomic/atomic[Atomic " -"CLI]. Please refer to the " -"https://github.com/projectatomic/atomic#atomic-uninstall[upstream " -"documentation] for more information." +"CLI]. Please refer to the https://github.com/projectatomic/atomic#atomic-" +"uninstall[upstream documentation] for more information." msgstr "" #. type: Plain text -#: ./pages/guidelines/creation.adoc:140 +#: pages/guidelines/creation.adoc:140 #, no-wrap -msgid "" -" uninstall=\"/usr/bin/docker run --rm --privileged -v /:/host IMAGE " -"/container/atomic-uninstall\"\n" +msgid " uninstall=\"/usr/bin/docker run --rm --privileged -v /:/host IMAGE /container/atomic-uninstall\"\n" msgstr "" #. type: Plain text -#: ./pages/guidelines/creation.adoc:142 +#: pages/guidelines/creation.adoc:142 msgid "" "'''url''': A URL where users can get more information about the image, such " "as a github or pagure repository, or software documentation." msgstr "" #. type: Plain text -#: ./pages/guidelines/creation.adoc:144 +#: pages/guidelines/creation.adoc:144 msgid "" "'''help''': A runnable command which outputs a man page or other \"help\" " "information. If supplied, must be tested with `atomic help`. If you have a " @@ -367,13 +350,13 @@ msgid "" msgstr "" #. type: Title === -#: ./pages/guidelines/creation.adoc:146 +#: pages/guidelines/creation.adoc:146 #, no-wrap msgid "Versioning" msgstr "" #. type: Plain text -#: ./pages/guidelines/creation.adoc:149 +#: pages/guidelines/creation.adoc:149 msgid "" "In the previous section there was coverage of LABELs, one of those is the " "Version that is set in the example using the `ENV` variable `VERSION` which " @@ -382,21 +365,21 @@ msgid "" msgstr "" #. type: Plain text -#: ./pages/guidelines/creation.adoc:151 +#: pages/guidelines/creation.adoc:151 msgid "" -"At this time there is no way to automatically populate the " -"`Version`/`VERSION` value with the same value of the latest version of the " -"primary RPM belonging to the container image. This is something that is " -"currently https://pagure.io/atomic-wg/issue/249[on the roadmap]." +"At this time there is no way to automatically populate the `Version`/" +"`VERSION` value with the same value of the latest version of the primary RPM " +"belonging to the container image. This is something that is currently " +"https://pagure.io/atomic-wg/issue/249[on the roadmap]." msgstr "" #. type: Plain text -#: ./pages/guidelines/creation.adoc:153 +#: pages/guidelines/creation.adoc:153 msgid "Why is this needed?" msgstr "" #. type: Plain text -#: ./pages/guidelines/creation.adoc:155 +#: pages/guidelines/creation.adoc:155 msgid "" "If we set the `Version` LABEL to the version of it's respective RPM at the " "time of the Container Image Review, then the maintainer will constantly have " @@ -405,61 +388,61 @@ msgid "" "RPM could be updated by the layered image automatic rebuilds and the " "maintainer isn't able to update the `Dockerfile` in a timely manner " "(Automatic Rebuilds are done by https://docs.pagure.org/releng/[Release " -"Engineering] in order to pull in security updates for all layered " -"images). If this were to happen, then the version of the container image " -"will not match the version of the software it's meant to deliver which would " -"lead to confusion and potentially unexpected negative side effects for " -"users. Therefore, for the time being we're saying that the version number of " -"the container is not meaningful but it will be as soon as possible." +"Engineering] in order to pull in security updates for all layered images). " +"If this were to happen, then the version of the container image will not " +"match the version of the software it's meant to deliver which would lead to " +"confusion and potentially unexpected negative side effects for users. " +"Therefore, for the time being we're saying that the version number of the " +"container is not meaningful but it will be as soon as possible." msgstr "" #. type: Title === -#: ./pages/guidelines/creation.adoc:157 +#: pages/guidelines/creation.adoc:157 #, no-wrap msgid "CMD / ENTRYPOINT" msgstr "" #. type: Plain text -#: ./pages/guidelines/creation.adoc:160 +#: pages/guidelines/creation.adoc:160 msgid "" "Another item required is a CMD or ENTRYPOINT entry so that when an user were " "run perform the following command (for example), expected behavior occurs.:" msgstr "" #. type: Plain text -#: ./pages/guidelines/creation.adoc:164 +#: pages/guidelines/creation.adoc:164 msgid "``` docker run registry.fedoraproject.org/f25/myawesomecontainer ```" msgstr "" #. type: Plain text -#: ./pages/guidelines/creation.adoc:166 +#: pages/guidelines/creation.adoc:166 msgid "" -"For more information on these entries, please reference the upstream " -"https://docs.docker.com/engine/reference/builder/[Dockerfile documentation]." +"For more information on these entries, please reference the upstream https://" +"docs.docker.com/engine/reference/builder/[Dockerfile documentation]." msgstr "" #. type: Title === -#: ./pages/guidelines/creation.adoc:168 +#: pages/guidelines/creation.adoc:168 #, no-wrap msgid "Volumes" msgstr "" #. type: Plain text -#: ./pages/guidelines/creation.adoc:171 +#: pages/guidelines/creation.adoc:171 msgid "" "The use of container volumes for persistent data is permitted and " "encouraged, but the following guidelines need to be followed:" msgstr "" #. type: Plain text -#: ./pages/guidelines/creation.adoc:173 +#: pages/guidelines/creation.adoc:173 msgid "" "Any user data that would be at risk of loss on update '''must''' be in a " "volume." msgstr "" #. type: Plain text -#: ./pages/guidelines/creation.adoc:174 +#: pages/guidelines/creation.adoc:174 msgid "" "Any application configuration data that requires persistence '''must''' be " "in a volume. Configuration by environment variables instead is also " @@ -467,54 +450,55 @@ msgid "" msgstr "" #. type: Plain text -#: ./pages/guidelines/creation.adoc:175 -msgid "All volumes listed in the Dockerfile '''must''' be listed in the Help File." +#: pages/guidelines/creation.adoc:175 +msgid "" +"All volumes listed in the Dockerfile '''must''' be listed in the Help File." msgstr "" #. type: Plain text -#: ./pages/guidelines/creation.adoc:176 +#: pages/guidelines/creation.adoc:176 msgid "" "The example run command '''should''' have the volume with a persistent name " -"(e.g. \"docker run -d -v owncloud-data:/var/lib/owncloud -v " -"owncloud-config:/etc/owncloud owncloud\")" +"(e.g. \"docker run -d -v owncloud-data:/var/lib/owncloud -v owncloud-config:/" +"etc/owncloud owncloud\")" msgstr "" #. type: Plain text -#: ./pages/guidelines/creation.adoc:177 +#: pages/guidelines/creation.adoc:177 msgid "" "Volumes '''must''' be defined as narrowly as possible. Specifically, unless " "the image is intended for use as a system container intended for system " "administration, volumes must be defined so as to mount system directories " -"which are exclusive to the container. For example, the container must mount " -"/etc/application-name/ for config files, ''not'' /etc/." +"which are exclusive to the container. For example, the container must mount /" +"etc/application-name/ for config files, ''not'' /etc/." msgstr "" #. type: Plain text -#: ./pages/guidelines/creation.adoc:179 +#: pages/guidelines/creation.adoc:179 msgid "Each volume in the Help File '''must''' have the following:" msgstr "" #. type: Plain text -#: ./pages/guidelines/creation.adoc:180 +#: pages/guidelines/creation.adoc:180 msgid "The full path of the volume" msgstr "" #. type: Plain text -#: ./pages/guidelines/creation.adoc:181 +#: pages/guidelines/creation.adoc:181 msgid "" "Why it is marked a volume (such as why this config needs persistence or " "indicating user data lives there)" msgstr "" #. type: Plain text -#: ./pages/guidelines/creation.adoc:183 +#: pages/guidelines/creation.adoc:183 msgid "" "Volumes listed in the Help File '''should''' also include information about " "space, permissions, and performance requirements." msgstr "" #. type: Plain text -#: ./pages/guidelines/creation.adoc:184 +#: pages/guidelines/creation.adoc:184 msgid "" "The readme '''may''' contain suggested additional volumes that aren't made " "mandatory by the Dockerfile, such as locations for generated, rather than " diff --git a/po/fr/master/pages/guidelines/creation.po b/po/fr/master/pages/guidelines/creation.po index 61a8054..55a732a 100644 --- a/po/fr/master/pages/guidelines/creation.po +++ b/po/fr/master/pages/guidelines/creation.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" -"POT-Creation-Date: 2023-01-27 13:55+0000\n" +"POT-Creation-Date: 2023-03-29 22:15+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -242,7 +242,7 @@ msgstr "" #. type: Plain text #: pages/guidelines/creation.adoc:120 msgid "" -"'''version''': Usually 0. Populated from the ENV variable. See \"VERSIONING" +"'''version''': Usually 0. Populated from the ARG variable. See \"VERSIONING" "\" below for explanation." msgstr ""