@itentialopensource/push-bundle-to-github v0.0.10-2021.2.1

Push Bundles to GitHub

Table of Contents

• Overview
• Installation Prerequisites
• Requirements
• Features
• How to Install
• How to Run

Overview

The Push Bundles to GitHub pre-built takes an Admin Essentials installed pre-built and creates a new project in GitHub using the up-to-date pre-built bundle. If the project and branch already exists in the specified GitHub group, it will create a new branch and open a pull request in GitHub with any changes made in the lab environment.

Installation Prerequisites

Users must satisfy the following pre-requisites:

• Itential Automation Platform
  • ^2021.2
• App-Artifacts
  • 6.1.16-2021.1.2
• GitHub Adapter

Requirements

This artifact requires the following:

• Artifact installed in Admin Essentials
• GitHub Organization Name

Features

The main benefits and features of the artifact are outlined below.

• Automatically create repo and branch.
• Automatically create Pull Request when repo and branch exist.
• Allows user to perform rediscovery of an installed artifact (where new components were added).
• Adds the current IAP user whoami username to the Pull Request description for the Pull Request reviewer.
• Auto artifact.json generator script
• Helps to handle "Artifact-As-Code" with version control, PR, and code-promotion procedures.

How to Install

To install this pre-built:

• Verify you are running a supported version of the Itential Automation Platform (IAP) as listed above in the Requirements section.
• The artifact can be installed from within App-Admin_Essential. Simply search for the name of your desired artifact and click the install button.

How to Run

Use the following to run the artifact:

1. In Automation Catalog, find the Push Bundles to GitHub entry.
2. Fill out the form with the appropriate values.
3. Continue with all manual tasks in the workflow.

Form Inputs (look for above screenshot for example inputs) 1. Adapter Name - Adapter name configured with user token 2. GitHub Project Name - Project name in GitHub to Update/Create 3. GitHub Organization Name - GitHub organization name to push repository 4. Re-discover - Perform re-discover 5. Artifact - name of the installed bundle to push onto remote repo 6. PR Type - Type of PR (patch/minor/major) 7. Commit Message - Commit message to add for commit tasks 8. Target Branch - Traget branch to set for PR