Cloud Services

Container Cluster Management

Common Actions: Onboarding by Discovery
Published On Dec 13, 2024 - 7:43 AM

Common Actions: Onboarding by Discovery

Learn how to onboard actions using the Discovery capability.
Actions Discovery allows you to import content and create your own actions. Select this option to create actions from scratch for playbooks discovered in a
GitHub
 or
Ansible Tower
 account.
The main benefit of Actions Discovery is that it enables you to bring your personalized action content available in your sources, such as GitHub or Ansible Tower using the user interface (UI). This makes the discovery of action content automatically and onboards the actions into the Kyndryl Bridge Applications very quickly.
Permission
Description
actions.action_types.crud
Allow to perform crud operation on action types
actions.action_onboarding.crud
Allow to perform crud operation on action onboarding
actions.action_definition.view
Allow to perform view operation on action definition
actions.action_definition.crud
Allow to perform crud operation on action definition
actions.action_policy.view
Allow to perform view operation on action policy
The onboarding process is divided into 4 steps:
  4. Onboarding actions
    1. Publishing onboarded actions
    2. Editing the action definition
    3. Adding an action configuration

Selecting content sources

  1. From the
    Actions Admin
     page, click
    onboard action +
    .
  2. Select
    Onboard by discovery
    .
  3. Click
    Ok
    .
  4. A new page is displayed. Select one of the following source types: GitHub or Ansible Tower.
  5. Select the
    source account
     to discover your actions from the dropdown list.
  6. Add the
    content technology
     from the dropdown list.
  7. Different content sources are displayed based on the source account selected. To look for a specific content source, use the search bar.
    1. For GitHub: Check the box next to the content name. A maximum of five sources can be selected.
    2. For Ansible Tower: Select
      Workflow
       or
      Template
      .
  8. Click
    Select and continue
    .
The discovery process initiates. You can wait for the discovery to finish or select to go to the
Actions Admin
 page.
Each type of content source has associated content technologies, which refers to the type of files to be discovered.

Discovering and selecting actions

After the discovery process is completed and successful, a tree structure opens.
  1. Select the action files that need to be onboarded.
  2. Click
    Save and Continue
    .

(Optional) Bulk assigning actions

  1. Select one or more actions to assign to a target provider. You can select multiple actions at once for a more expedited process. However, only one provider can be assigned to those actions.
  2. Click
    Bulk Assign
    , select the target provider to be assigned, and click
    Continue
    .

Onboarding actions

You are presented with a summary of the actions to be onboarded and the target provider for each of them. Click
Save and Continue
 to start the onboarding process.
Publishing onboarded actions.
To publish your recently discovered actions, follow these steps:
  1. Edit the action definition.
  2. Add an action configuration.
Editing the action definition
  1. Select the action that you want to onboard and click the
    overflow menu
    .
  2. Select
    Details
    . The Details page opens.
  3. Click
    Edit details
    .
  4. Make the necessary edits to the action's details and save the changes.
The details page shows the following fields for you to update, if needed:
  • Action Definition ID:
     ID used for linking actions files.
  • Action Definition Display Label:
     Label shown to the user on the application side.
  • Action Type:
     Select
    Config Change
     if you need the user to enter some data to execute the action. Otherwise, classify your action as State Change, Deprovision, or Provision New.
  • Description:
     A brief description of what this action is for.
  • Actions template:
     A template containing key information for the execution of the template. For example, the link between resource information and the playbook variables. For more information, click the
    Information
     icon.
  • Associated to resource family:
     Resource families where this action is shown.
  • Context:
     Scope for action execution.
  • Application:
     Application where the user can run this action from.
  • Content Provider:
     Usually the content source.
  • Target Provider:
     Cloud provider where the action is performed.
  • Fulfillment Provider:
     Tool provider in charge of execution.
Adding an action configuration
  1. When
    Action Type
     has been set to
    Config Change
    , the actions require some input from the user. To configure these inputs, click
    Manage Configuration
    .
    Remember to save any other changes made to the details page before going to the Manage Configuration page.
  2. Add the configuration name of your choice. You can add as many configurations as inputs are required from the user.
  3. Click
    View more
     in each of the configuration IDs added to make the required configuration updates.
    Important:
    Config Id
     and
    Binding
     usually take the same value. This value is linked to the playbook through the Action Template.
    • For
      Input type:
      • Select
        Free Text
         to display an input box where the user can enter any text.
      • Select
        Single Select
         to display a dropdown menu where the user can select only one choice.
      • Select
        Multi Select
         to display a dropdown menu where the user can select more than one choice.
    • For
      Description:
       This is a help text displayed so the user knows important information about that input.
    • For
      Validation:
       This is a regex expression used to validate the user input. If validation fails, then whatever is in the
      Error Message
       text box is shown.
Do you have two minutes for a quick survey?
Take Survey