Bug 1389129

Summary: [Docs] [RFE] [OSE] Provide an overview of auto-tagging of TLO based on OSE labels
Product: Red Hat CloudForms Management Engine Reporter: Andrew Dahms <adahms>
Component: DocumentationAssignee: Dayle Parker <dayleparker>
Status: CLOSED CURRENTRELEASE QA Contact: Chris Budzilowicz <cbudzilo>
Severity: medium Docs Contact:
Priority: medium    
Version: 5.7.0CC: cben, cbudzilo, hhudgeon, jhardy, obarenbo
Target Milestone: GAKeywords: FutureFeature
Target Release: 5.7.0   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2017-01-30 01:18:13 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: Container Management Target Upstream Version:

Description Andrew Dahms 2016-10-27 00:19:51 UTC
Red Hat CloudForms adds the ability to auto-tag TLO based on labels in OpenShift. An overview of this process must be provided.

Comment 1 Andrew Dahms 2016-11-18 04:33:12 UTC
Assigning to Dayle for review.

Comment 2 Andrew Dahms 2016-11-21 20:56:25 UTC
From Beni Paskin-Cherniavsky in BZ#1396126 -

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 3 Andrew Dahms 2016-11-21 20:57:37 UTC
*** Bug 1396126 has been marked as a duplicate of this bug. ***

Comment 5 Andrew Dahms 2016-12-12 04:40:38 UTC
Changing the QA contact to Chris.