Bug 1396126

Summary: Document new label -> tag mapping feature
Product: Red Hat CloudForms Management Engine Reporter: Beni Paskin-Cherniavsky <cben>
Component: DocumentationAssignee: Red Hat CloudForms Documentation <cloudforms-docs>
Status: CLOSED DUPLICATE QA Contact: Red Hat CloudForms Documentation <cloudforms-docs>
Severity: unspecified Docs Contact:
Priority: unspecified    
Version: 5.7.0CC: adahms, bazulay, hhudgeon, jhardy, lavenel, obarenbo, zgalor
Target Milestone: GA   
Target Release: cfme-future   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard: container
Fixed In Version: Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2016-11-21 20:57:37 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: Feature
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:

Description Beni Paskin-Cherniavsky 2016-11-17 13:47:18 UTC 
Document URL: 
https://access.redhat.com/documentation/en/red-hat-cloudforms/4.2-beta/paged/general-configuration/chapter-4-configuration#tags

Section Number and Name: 4.1.1.4. Tags

Describe the issue: 
5.7 exposes in UI a new feature: configuring automatic tagging of container entities according to their labels in kubernetes/openshift:
https://bugzilla.redhat.com/show_bug.cgi?id=1383405 (cfme-future)
https://bugzilla.redhat.com/show_bug.cgi?id=1391137 (5.7.0)
https://github.com/ManageIQ/manageiq/pull/11591
(this PR has many screenshots, although they don't 100% match final code)

very quick summary of the feature:

It lives under top right menu -> Configuration -> ManageIQ Region 0 -> new tab called "Map Tags".
There user can add "mapping rules", e.g. given openshift/kubernetes labels with key "zone", automatically tag with category named "Zone" — then an entity labeled "zone=japan" label would be get a "Zone : Japan" tag (in *addition* to showing the label in Labels table), "zone=us-east" would get "Zone : us-east" tag etc.

- These rules take effect on each refresh.  If the label changes/disappears, so do the produced tag.
- The category name user types is *not* one of a categories in My Company Categories tab, a new category is created automatically and it must be distinct from existing category names.
- The tags created this way are completely managed by the system, they can't be manually assigned/unassigned.
- Deleting a mapping rule immediately deletes the resulting tags.

There are more subtle points, don't hesitate to ask anything.


Additional information: 

kubernetes/openshift docs on labels:
http://kubernetes.io/docs/user-guide/labels/
https://docs.openshift.com/container-platform/3.3/architecture/core_concepts/pods_and_services.html#labels

P.S. sorry for opening this so very late.  I should work on my bugzilla phobia :-|
Comment 1 Loic Avenel 2016-11-17 13:59:35 UTC 
I have a running system form which we can take snapshots.
Comment 2 Andrew Dahms 2016-11-21 20:57:37 UTC 
Hi Beni,

Thank you for raising this bug.

We already have a tracker for this RFE raised as BZ#1389129, which is now assigned to Dayle.

I will close this bug as a duplicate, but have copied over your comments, which will be very helpful, and we will track the changes over there going forward.

Kind regards,

Andrew

*** This bug has been marked as a duplicate of bug 1389129 ***