npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

@itentialopensource/migration-wizard

v0.0.1-2019.3.2

Published

Migration Wizard allows users to bundle and migrate components from one environment to another. This automation will create an artifact and return a tarball the user can download.

Downloads

8

Vulnerabilities

Powered byPowered by Snyk
  • 0High
  • 0Medium
  • 0Low

Links

Git

Maintainers

andyknaebelandyknaebeljohnpolanskyjohnpolanskyjared.obrienjared.obriencharlie.wilsoncharlie.wilsonzack.strulovitchzack.strulovitchitential-ciitential-ci

Keywords

ItentialIAPApp-Artifactsartifactsmigration

Readme

Migration Wizard

Table of Contents

Intro

The Migration Wizard enables IAP users to conveniently move their automation use cases between their different IAP environments (e.g. from Dev to Pre-Production or from Lab to Production). This artifact will discover all components in IAP that are required to run an automation and bundles these components into a single exported .tgz file. This file can be imported on any other IAP server through app-artifacts without the need for an internet connection.

Requirements

In order to use the Migration Wizard automation, users will have to satisfy the following pre-requisites:

  • Itential Automation Platform
    • ^2019.2.4
  • App-Artifacts
    • ^2.6.2

Known Limitations

Migration Wizard does NOT currently discover service dependencies that are not default IAP services (apps or adapters). These services must be added manually when migrating between environments as the required service will NOT be a part of the user's bundled artifact.

How to Install

Please ensure that you are running a supported version of Itential Automation Platform (IAP) as listed above in the Pre-Requisites section in order to install Migration Wizard. If you do not currently have App-Artifacts installed as a service on your node, the .tgz file or "tarball" can be obtained from the Nexus repository. Please refer to the instructions included in the App-Artifacts README to install it.

Migration Wizard can be installed from within App-Artifacts. Simply search for migration-wizard and click the install button as shown below:

Alternatively, you may clone this repository and run npm pack to create a tarball which can then be installed via the offline installer in App-Artifacts. Please consult the documentation for App-Artifacts for further information.

How to Run

Input

To run the Migration Wizard artifact, the user can choose between two options. The first, is to start the artifact from Automation Catalog, which is done through the Itential Automation Platform (IAP) GUI. The second option is to make a HTTP Request to the server via Postman. Instructions on how to execute both options are listed below.

Run with Automation Catalog

First, the user will need to access the artifact entry through Automation Catalog as seen below.

From Automation Catalog, the user can select to start the automation by clicking the run option, which can be seen in the following image.

After choosing to run the automation, the user will be promted for an Automation Catalog or Workflow to perform migration on.

After the user clicks the Run button, Migration Wizard will discover all dependencies required by the Automation Catalog or Workflow item, as well as version information for each IAP application required to install the bundled artifact. The results of the discovery will then be displayed to the user for them to confirm:

Migration Wizard will next prompt the user for metadata for the bundle, giving the user an opportunity to provide a short description and any keywords relevant to the artifact bundle. Once these two parameters are provided, the user will then be asked to complete a README template for their artifact bundle.

Once the metadata is collected, Migration Wizard will perform a health check to gather module information in order to properly bundle the artifact. Please note that this step will not be required to run in future versions of Migration Wizard. The user will be prompted to perform the health check as an admin user:

Migration Wizard will bundle all dependencies and create the required files needed to install the outputted tarball into a new environment. Upon success of this process, the user will be provided with the option to download their bundled artifact:

Output

After the artifact has completed running the automation, the user will be presented with a .tgz file containing all of the necessary components required to run their initial Automation Catalog or Workflow.