Documentation

Nomirun initialization

Open up the PowerShell and type nomirun, or nomi for short. If you see the help screen, your CLI has installed successfully.

Next step is to run nomirun init command to initialize the Nomirun on your PC.

1. Download the latest versions of Nomirun Hosts

First latest versions of Nomirun Hosts are automatically downloaded for your OS:

               Downloading Nomirun Host net8.0 ---------------------------------------- 100% 00:00:00
 Downloading Nomirun Host net8.0 for debugging ---------------------------------------- 100% 00:00:00
               Downloading Nomirun Host net9.0 ---------------------------------------- 100% 00:00:00
 Downloading Nomirun Host net9.0 for debugging ---------------------------------------- 100% 00:00:00
              Downloading Nomirun Host net10.0 ---------------------------------------- 100% 00:00:00
Downloading Nomirun Host net10.0 for debugging ---------------------------------------- 100% 00:00:00
               


2. Configure Nuget server(s)

As a final step you need to specify Nuget server where you will host your Nomirun modules. When building a module, you specify the server name to which you want to publish the Nomirun module NuGet package (nupkg).

Welcome to Nomirun CLI initialization.
In order to build and run modules, you need to specify Which Nuget server you want to configure? You can configure one or more. For development we suggest you use `LocalFolder`.

[] Azure DevOps
[] GitHub <
[] Baget
[] Feedz.io
               

Currently, we support four options for Nuget server; you can select 1 or more:

  1. Azure DevOps
  2. GitHub
  3. Baget - if you run your own instance of Baget NuGet server, you can select it.
  4. Feedz.io - is an alternative feed that is very flexible.

Once you select Nuget server(s), wizard will navigate you to configure it. In the end, the configuration is stored.

You can also rerun the initialization, overwriting the configuration file previously created.

3.1 Azure DevOps

Nomirun supports Azure DevOps Artifacts as a Nuget server.

In the nomi init wizard, you can select Azure DevOps option and enter these parameters:

  1. Azure DevOps Artifacts feed URL
  2. Azure DevOps organization name
  3. Use Interactive mode (select y)
  4. Skip duplicated packages (we suggest selecting y option)
  5. Store password in clear text (we suggest selecting n option)

You need to have access to Azure DevOps project Artifacts and Install Azure Artifacts credential provider if you do not have Visual Studio (version 15.9+) installed on your machine.

3.2 GitHub

Nomirun supports the GitHub package repository as a Nuget server.

In the nomi init wizard, you can select GitHub option and enter these parameters:

  1. GitHub Nuget package repository URL (https://nuget.pkg.github.com/NAMESPACE/index.json. Replace NAMESPACE with your GitHub username / organization.)
  2. GitHub name (your GitHub username / organization name)
  3. GitHub Legacy PAT token
  4. Use Interactive mode (select n)
  5. Skip duplicated packages (we suggest selecting the y option)
  6. Store password in clear text (we suggest selecting the n option)

Check GitHub documentation to get the URL, username and PAT token.

3.3 Baget

Nomirun supports Baget server as a Nuget server.

In the nomi init wizard, you can select Baget option and enter these parameters:

  1. Baget feed URL
  2. Baget API key
  3. Use Interactive mode (select n)
  4. Skip duplicated packages (we suggest selecting the y option)
  5. Allow insecure connection to Baget server (HTTP/HTTPS) (it depends on your Baget configuration)
  6. Store password in clear text (we suggest selecting the n option)

Check Baget documentation to get the URL and ApiKey.

3.4 Feedz.io

Nomirun supports Feedz.io server as a Nuget server.

In the nomi init wizard, you can select Feedz.io option and enter these parameters:

  1. Feedz.io feed URL
  2. Feedz.io API key
  3. Use Interactive mode (select n)
  4. Skip duplicated packages (we suggest selecting the y option)
  5. Store password in clear text (we suggest selecting the n option)

Check Feedz.io documentation to get the URL and ApiKey.