Files
podman/docs/source/markdown/options/file.md
Jan Kaluza 7612af4c0e Rewrite the Quadlet documentation
This commit does the following:

- Splits the podman-systemd.unit.5.md into multiple files - one for each quadlet file type.
- Adds the podman-quadlet-basic-usage.7.md for quadlet examples.
- Majority of the text in the new files is copied from the podman-systemd.unit.5.md
- Adds support for very simple condditional in the markdown_preprocess.
- Uses new logic in markdown_preprocess in options/*.md to use a single .md file for both
  podman subcommands man-pages and quadlet man-pages. This deduplicates the Quadlet man-pages a lot.
- Adds new `@@option quadlet:source.md`` preprocess command to import such .md files from options directory.

Signed-off-by: Jan Kaluza <jkaluza@redhat.com>
2026-05-04 10:53:36 +02:00

1.2 KiB

####> This option file is used in: ####> podman build, podman-build.unit.5.md.in, farm build ####> If file is edited, make sure the changes ####> are applicable to all of those. << if is_quadlet >>

File=Containerfile

<< else >>

--file, -f=Containerfile

<< endif >>

Specifies a Containerfile which contains instructions for building the image, either a local file or an http or https URL. If more than one Containerfile is specified, FROM instructions are only accepted from the last specified file.

<< if is_quadlet >> Note that for a given relative path to a Containerfile, or when using a http(s):// URL, also set SetWorkingDirectory= in order for podman build to find a valid context directory for the resources specified in the Containerfile.

Note that setting a File= field is mandatory for a .build file, unless SetWorkingDirectory (or a WorkingDirectory in the Service group) has also been set. << else >> If a build context is not specified, and at least one Containerfile is a local file, the directory in which it resides is used as the build context. << endif >>

Specifying the option << 'File=-' if is_quadlet else '-f -' >> causes the Containerfile contents to be read from stdin.