From 615beee1ae0fd9b299fc38ac0989d4be5899c19b Mon Sep 17 00:00:00 2001 From: Colin McDonnell Date: Tue, 19 Sep 2023 13:48:59 -0700 Subject: More improvements to azure guide --- docs/guides/install/azure-artifacts.md | 18 ++++++++++-------- 1 file changed, 10 insertions(+), 8 deletions(-) (limited to 'docs/guides/install') diff --git a/docs/guides/install/azure-artifacts.md b/docs/guides/install/azure-artifacts.md index a317dff43..659e75fd6 100644 --- a/docs/guides/install/azure-artifacts.md +++ b/docs/guides/install/azure-artifacts.md @@ -8,17 +8,13 @@ In [Azure Artifact's](https://learn.microsoft.com/en-us/azure/devops/artifacts/n [Azure Artifacts](https://azure.microsoft.com/en-us/products/devops/artifacts) is a package management system for Azure DevOps. It allows you to host your own private npm registry, npm packages, and other types of packages as well. -To use it with `bun install`, add a `bunfig.toml` file to your project with the following contents: - --- ### Configure with bunfig.toml --- -Make sure to replace `my-azure-artifacts-user` with your Azure Artifacts username, such as `jarred1234`. - -Set the `$NPM_PASSWORD` environment variable to your Azure Artifacts npm registry password and Bun will automatically replace it with the correct value. You can also choose not to use an environment variable and instead hardcode your password in the `bunfig.toml` file, but be careful not to commit it to source control. +To use it with `bun install`, add a `bunfig.toml` file to your project with the following contents. Make sure to replace `my-azure-artifacts-user` with your Azure Artifacts username, such as `jarred1234`. ```toml#bunfig.toml [install.registry] @@ -30,13 +26,19 @@ password = "$NPM_PASSWORD" --- -### Configure with environment variables +Then assign your Azure Personal Access Token to the the `NPM_PASSWORD` environment variable. Bun [automatically reads](/docs/runtime/env) `.env` files, so create a file called `.env` in your project root. There is no need to base-64 encode this token! Bun will do this for you. + +```txt#.env +NPM_PASSWORD= +``` --- -You can also use an environment variable to configure Azure Artifacts with `bun install`. +### Configure with environment variables + +--- -Like with the `npm` CLI, the environment variable to use is `NPM_CONFIG_REGISTRY`. The URL should include `:username` and `:_password` as query parameters. Replace `` and `` with the apprropriate values. +To configure Azure Artifacts without `bunfig.toml`, you can set the `NPM_CONFIG_REGISTRY` environment variable. The URL should include `:username` and `:_password` as query parameters. Replace `` and `` with the apprropriate values. ```bash#shell NPM_CONFIG_REGISTRY=https://pkgs.dev.azure.com/my-azure-artifacts-user/_packaging/my-azure-artifacts-user/npm/registry/:username=:_password= -- cgit v1.2.3