RHEL Engineering is moving the tracking of its product development work on RHEL 6 through RHEL 9 to Red Hat Jira (issues.redhat.com). If you're a Red Hat customer, please continue to file support cases via the Red Hat customer portal. If you're not, please head to the "RHEL project" in Red Hat Jira and file new tickets here. Individual Bugzilla bugs in the statuses "NEW", "ASSIGNED", and "POST" are being migrated throughout September 2023. Bugs of Red Hat partners with an assigned Engineering Partner Manager (EPM) are migrated in late September as per pre-agreed dates. Bugs against components "kernel", "kernel-rt", and "kpatch" are only migrated if still in "NEW" or "ASSIGNED". If you cannot log in to RH Jira, please consult article #7032570. That failing, please send an e-mail to the RH Jira admins at rh-issues@redhat.com to troubleshoot your issue as a user management inquiry. The email creates a ServiceNow ticket with Red Hat. Individual Bugzilla bugs that are migrated will be moved to status "CLOSED", resolution "MIGRATED", and set with "MigratedToJIRA" in "Keywords". The link to the successor Jira issue will be found under "Links", have a little "two-footprint" icon next to it, and direct you to the "RHEL project" in Red Hat Jira (issue links are of type "https://issues.redhat.com/browse/RHEL-XXXX", where "X" is a digit). This same link will be available in a blue banner at the top of the page informing you that that bug has been migrated.
Bug 1270658 - [DOCS] [7.2] [Feature] Document an Atomic CLI Reference
Summary: [DOCS] [7.2] [Feature] Document an Atomic CLI Reference
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Deadline: 2015-11-13
Product: Red Hat Enterprise Linux 7
Classification: Red Hat
Component: doc-RHEL-Atomic
Version: 7.1
Hardware: Unspecified
OS: Unspecified
high
high
Target Milestone: rc
: 7.2
Assignee: Yoana Ruseva
QA Contact: Vikram Goyal
Vikram Goyal
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2015-10-12 05:05 UTC by Vikram Goyal
Modified: 2019-03-06 01:05 UTC (History)
7 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2015-11-19 14:10:52 UTC
Target Upstream Version:
Embargoed:

Attachments (Terms of Use)

Description Vikram Goyal 2015-10-12 05:05:48 UTC 
As a customer I want documentation providing a reference to the complete AH CLI features and commands. At the moment, there is no one guide that provides all the commands and features for the CLI that can be used.

This will be a brand new guide.

Suggested name:

RHEL Atomic Host CLI Reference

Suggested contact:

Dan Walsh (for features)

This is targeted to be released with 7.2.
Comment 2 Yoana Ruseva 2015-10-30 12:20:58 UTC 
Hello Daniel, is this a good text to start with? 

https://github.com/projectatomic/atomic

What are the most important features for 7.2?
Comment 3 Daniel Walsh 2015-10-30 15:16:31 UTC 
Yes.

Atomic mount and atomic scan are the most important features for 7.2
Comment 4 Daniel Walsh 2015-10-30 15:17:04 UTC 
Brent do you have any write up on these features?
Comment 12 Yoana Ruseva 2015-11-10 16:48:00 UTC 
Hi, here is a draft of the document:

https://gitlab.cee.redhat.com/rhel-atomic-host-documentation/atomic-host-content/blob/atomic-CLI/atomic_cli/atomic_cli.adoc

Since it's a reference document, I used the man pages extensively, but tried to add some more info wherever possible. For the finer details and options, I still referred to the man pages though. Any ideas of how to make it more useful are welcome. (I found the man pages pretty useful themselves)

1) where can people find the atomic manual pages? rpm-ostree is available with the rhel-tools container, but atomic isn't

2) can I have examples for atomic mount? what is the use case for it? Current text is same as the manual page

3) if the install label is not there, what does atomic install do?

P.S. Just found this blog post - http://rhelblog.redhat.com/2015/09/23/recent-updates-to-the-atomic-cli/ so I will expand the explanation of install with the expamples there.

Any sort of feedback is welcome.
Comment 14 Brent Baude 2015-11-10 19:25:14 UTC 
1) I have filed https://bugzilla.redhat.com/show_bug.cgi?id=1280031 to have atomic included into the rhel-tools image.

2) I believe the atomic mount was developed to allow users to inspect the contents of an image or container's filesystem.  This could be handy to check anything from configuration files to accessing the rpmdb "inside" the docker object.

3) As of today, it dropped me into a sh prompt within the image/container namespace.  I think this is a bug but will need Dan Walsh to confirm.  IMHO, if no LABEL=INSTALL is present, then atomic install should fail gracefully with a message like "No run label found; no action taken"

@dwalsh, I wasn't helping with atomic code when install was implemented so your perspective here is key. If you prefer the alternative from above, I think that is a quick fix I can do and turn around quickly.
Comment 18 Yoana Ruseva 2015-11-12 20:53:23 UTC 
Brent, thanks for the feedback. I have edited atomic install and run and other minor things.

I like the example for /etc/rsyslog.conf but I saw it in the RUN label. Are there any similar examples handy?

about fetch-cve=True in /etc/oscapd.conf, does it take precedence over the command line?

https://access.qa.redhat.com/documentation/en/red-hat-enterprise-linux-atomic-host/version-7/cli-reference/
Comment 20 Yoana Ruseva 2015-11-17 11:59:33 UTC 
New version available here:

https://access.qa.redhat.com/documentation/en/red-hat-enterprise-linux-atomic-host/version-7/cli-reference/

Explained "atomic install" in more details.

In the meantime, "atomic migrate" was included

https://github.com/projectatomic/atomic/blob/master/docs/atomic-migrate.1.md

Brent, is the current text OK to be published as it is?

Vikram, given that Atomic CLI is changing realtime, shall we keep this BZ open and publish asynchronously?
Comment 23 Yoana Ruseva 2015-11-19 14:10:52 UTC 
The Reference Guide has been published:

https://access.redhat.com/documentation/en/red-hat-enterprise-linux-atomic-host/7/cli-reference/cli-reference

Closing the Bug.
Note You need to log in before you can comment on or make changes to this bug.