azure

Usage

To start adding registry items from an Azure DevOps repository you can run the following command:

jsrepo add azure/<org>/<project>/<repo>

The Azure provider understands refs as either branches or tags:

jsrepo add azure/<org>/<project>/<repo>/heads/<ref>
jsrepo add azure/<org>/<project>/<repo>/tags/<ref>

Custom base urls

By default the Azure provider will use https://dev.azure.com as the base url. You can configure this behavior by configuring azure in your jsrepo.config file:

import { defineConfig } from "jsrepo";
import { azure } from "jsrepo/providers";

export default defineConfig({
	providers: [azure({ baseUrl: "https://dev.azure.com" })], 
});

Alternatively you can use the azure:https://<url> shorthand to use a custom base url without having to touch your config file:

jsrepo add azure:https://dev.azure.com/<org>/<project>/<repo>/heads/<ref>

This syntax tells the Azure provider that it can resolve this URL as an Azure DevOps repository.

Deploying your registry to Azure DevOps

When deploying your registry to Azure DevOps you will want to use the repository output type:

import { defineConfig } from "jsrepo";
import { repository } from "jsrepo/outputs"; 

export default defineConfig({
	registry: {
		// ...
		outputs: [repository()], 
	},
});

This will create a registry.json file that will contain everything users need to use your registry.

Authentication

To authenticate with Azure DevOps you can run the following command:

jsrepo auth azure

You can logout of your account by running:

jsrepo auth azure --logout

Environment Variable

If you prefer to use an environment variable or are in an environment where you can't use the jsrepo auth command you can provide the token via the AZURE_TOKEN environment variable.

AZURE_TOKEN=... jsrepo add 

Options