Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[CI:DOCS] Touch up Containerfile man page to show ARG can be 1st #3577

Merged

Conversation

TomSweeneyRedHat
Copy link
Member

The Containerfile man page says FROM must be the first statement
in the file. However, that is not true as the ARG instruction can proceed it.

Fixes: #3555

Signed-off-by: TomSweeneyRedHat tsweeney@redhat.com

What type of PR is this?

/kind bug

What this PR does / why we need it:

Fixes the Containerfile man page which stated FROM had to be the first instruction, when it is permissible to have ARG.

How to verify it

Read

Which issue(s) this PR fixes:

Special notes for your reviewer:

Does this PR introduce a user-facing change?

None

@openshift-ci
Copy link
Contributor

openshift-ci bot commented Oct 8, 2021

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: TomSweeneyRedHat

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@openshift-ci openshift-ci bot added the approved label Oct 8, 2021
@TomSweeneyRedHat
Copy link
Member Author

@derkoe @rhatdan PTAL

valid image. It is easy to start by pulling an image from the public
valid Containerfile must have either **ARG** or *FROM** as its first instruction.
If **FROM** is not the first instruction in the file, it may only be preceded by
one or more ARG instructions, which declare arguments that are used in FROM lines in the Containerfile.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just to nitpick, aren't ARGs only used by the next FROM command. IE
ARG FOO=bar
from fedora
from $FOO

Does not work. From reading this description, I would assume it does.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

That's a good nit to pick. Perhaps "... are used in the next FROM line in the Containerfile."

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

SGTM

The Containerfile man page says FROM must be the first statement
in the file.  However, that is not true as the ARG instruction can proceed it.

Addresses: containers#3555

Signed-off-by: TomSweeneyRedHat <tsweeney@redhat.com>
@rhatdan
Copy link
Member

rhatdan commented Oct 9, 2021

/lgtm

@openshift-ci openshift-ci bot added the lgtm label Oct 9, 2021
@openshift-merge-robot openshift-merge-robot merged commit e47f4a1 into containers:main Oct 9, 2021
@github-actions github-actions bot locked as resolved and limited conversation to collaborators Sep 15, 2023
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Containerfile man page says FROM "must be first command"
3 participants