Script Repositories Integration
This feature is only available in the Nerdio Manager Premium edition.
Nerdio Manager is integrated with our public GitHub repositories. That means you have access to all the scripted actions in those repositories. which are constantly enhanced and added to, and then automatically downloaded and integrated with your Nerdio Manager installation. The Nerdio Manager script repository is called NMW and, by default, is linked to your installation.
Note: Should you not wish to have this repository linked to your installation, you can unlink it. See Unlink a Script Repository for details.
In addition, you can connect to your own script repositories. This allows you to take advantage of your repository's powerful features such as versioning, branching, and team collaboration, while automatically synchronizing all the linked repository changes to Nerdio Manager.
Note: By default, GitHub integration is enabled in Nerdio Manager. All other Nerdio Manager-integrated repository services, for example Azure DevOps, must be enabled before you can link to their repositories. See Enable Integration for details.
Link to a Script Repository
You can link a script repository to Nerdio Manager.
To link to a script repository:
Navigate to Settings > Integrations.
In the Script repositories tile, select Link repository.
Enter the following information:
Service: From the drop-down list, select the service.
For GitHub:
Account: Type your account name.
For example, https://github.com/AccountName/RepositoryName
Repository: Type the repository name.
Access token: From the drop-down list, select an existing token. Alternatively, paste the token generated in your repository.
Note: If you are linking to a private repository, you must create an access token. You can save the token in Nerdio Manager and it appears in the drop-down list for you to select. See Add a Script Repository Token for more information.
See this GitHub article for more information about creating an access token in GitHub.
For GitHub Enterprise:
Enterprise Server URL: Type your GitHub Enterprise URL.
For example, https://git.example.com.
Account: Type your account name.
For example, https://git.example.com/AccountName/RepositoryName
Repository: Type the repository name.
Access token: From the drop-down list, select an existing token. Alternatively, paste the token generated in your repository.
For Azure DevOps:
- Organization URL: Type your Azure DevOps organization URL.
For example, https://dev.azure.com/Microsoft.
Project: Type your Azure DevOps project name.
Repository: Type the repository name.
Access token: From the drop-down list, select an existing token. Alternatively, paste the token generated in your repository.
- Organization URL: Type your Azure DevOps organization URL.
Enter the path-branch-file extensions information that you want to synchronize with scripted actions.
Note: You may add as many path-branch-file extension rows as desired.
Select Add to add a new row.
Select
to delete an existing row.
Path: Type the path within your repository.
Branch: Type the branch within your repository.
File extensions: Type the extensions of files.
Execution environment: From the drop-down list, select the types of scripted actions contained within this path - Windows scripts or Azure runbooks.
Include subfolders: Select this option to recursively include all subfolders within the specified path.
Auto-synchronization enabled: Toggle on the auto-synchronization option so that changes to scripts within the repository are automatically synchronized with scripted actions every hour.
Note: Repositories can also be synchronized on-demand. See Manually Synchronize a Script Repository for details.
When you have entered all the desired information, select OK.
The script repository is linked to Nerdio Manager.
Note:
You can see the progress of the linking process in the Settings Tasks section at the bottom of the window.
Once the linking process is complete, the scripted actions in the script repository are available to be used. See Scripted Actions Overview for details about scripted actions.
Manually Synchronize a Script Repository
If the script repository is configured to auto-synchronize, Nerdio Manager automatically synchronizes the repository once an hour. Whether the script repository auto-synchronizes or not, you can manually synchronize the script repository whenever you desire.
To manually synchronize a script repository:
Navigate to Settings > Integrations.
In the Script repositories tile, locate the link you wish to synchronize.
Select
.
Review the confirmation pop-up and select OK.
The script repository is synchronized to Nerdio Manager.
Note: If you delete a scripted action in your script repository, it is still visible inside Nerdio Manager. This protects any configurations that may be using the scripted action. You may continue to use the scripted action in Nerdio Manager. Alternatively, you may delete it.
It goes into an "orphan" state that is flagged in the list of scripts. For example:
Unlink a Script Repository
You can unlink a script repository from Nerdio Manager.
Warning: Unlinking a script repository removes all scripted actions synchronized from the repository.
To unlink a script repository:
Navigate to Settings > Integrations.
In the Script repositories tile, locate the link you wish to unlink.
Select unlink.
Review the confirmation pop-up.
Warning: Nerdio Manager checks if any of the scripted actions in the repository are currently used in any configurations. If they are used, it warns you and shows you where they are used. You must tell Nerdio Manager to force the removal of the scripted actions from the configurations.
Force: If necessary, select this option to force the removal of the scripted actions.
Select OK.
The script repository is unlinked from Nerdio Manager and all the scripted actions are removed.
Add a Script Repository Token
Nerdio Manager allows you to add your script repository tokens so they can be used to link to your repositories.
To add a script repository token:
Navigate to Settings > Integrations.
In the Script repositories tile, select Add token.
Enter the following information:
Token name: Type the name for your token that is displayed when linking repositories.
Service: From the drop-down list, select the service.
Access token: Paste the token generated by your script repository.
Once you have entered all the desired information, select OK.
The script repository token is added to Nerdio Manager.
Remove a Script Repository Token
Nerdio Manager allows you to remove your script repository tokens.
To remove a script repository token:
Navigate to Settings > Integrations.
In the Script repositories tile, locate the token you wish to remove.
Select remove.
Review the confirmation pop-up and select OK.
The script repository token is removed from Nerdio Manager.
Enable Integration
By default, GitHub integration is enabled in Nerdio Manager. All other Nerdio Manager-integrated repository services, for example Azure DevOps, must be enabled before you can link to their repositories.
To enable integration:
Navigate to Settings > Integrations.
In the Script repositories tile, locate the repository service you wish to enable.
For example, Azure DevOps status: Disabled.
If the repository service's status is currently Disabled, select Disabled to enable it.
Review the confirmation pop-up and select OK.
The repository service is now enabled in Nerdio Manager
Disable Integration
You can disable an integrated script service from Nerdio Manager.
Warning: Disabling a script repository service removes all scripted actions synchronized from all the repositories in the service.
To disable integration:
Navigate to Settings > Integrations.
In the Script repositories tile, locate the repository service you wish to disable.
If the repository service's status is currently Enabled, select Enabled to disable it.
Review the confirmation pop-up.
Warning:Nerdio Manager checks if any of the scripted actions in the any of the service's repositories are currently used in any configurations. If they are used, it warns you and shows you where they are used. You must tell Nerdio Manager to force the removal of the scripted actions from the configurations.
Force: If necessary, select this option to force the removal of the scripted actions.
Select OK.
The script repository service is disabled from Nerdio Manager and all the scripted actions are removed.
Comments (0 comments)