Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions cli/azd/docs/environment-variables.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,7 @@ Environment variables that can be used to configure `azd` behavior, usually set
- `AZD_DEMO_MODE`: If true, enables demo mode. This hides personal output, such as subscription IDs, from being displayed in output.
- `AZD_FORCE_TTY`: If true, forces `azd` to write terminal-style output.
- `AZD_IN_CLOUDSHELL`: If true, `azd` runs with Azure Cloud Shell specific behavior.
- `AZD_NON_INTERACTIVE`: If set to a truthy value (`true`, `1`, `TRUE`, etc.), enables non-interactive (no-prompt) mode. This is equivalent to passing the `--no-prompt` or `--non-interactive` flag. Setting this variable (even to `false`) suppresses agent auto-detection, giving you explicit control over the mode. Priority order: explicit `--no-prompt`/`--non-interactive` flag (highest) > `AZD_NON_INTERACTIVE` env var > agent auto-detection (lowest).
- `AZD_SKIP_UPDATE_CHECK`: If true, skips the out-of-date update check output that is typically printed at the end of the command.

For tools that are auto-acquired by `azd`, you are able to configure the following environment variables to use a different version of the tool installed on the machine:
Expand Down
28 changes: 28 additions & 0 deletions cli/azd/docs/external-authentication.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,33 @@
# External Authentication

## Getting a Token via `azd auth token`

The `azd auth token` command can be used to print an access token for the currently signed-in account. This is useful for scripts and tools that need to authenticate against Azure APIs.

```bash
# Print the raw access token (default)
azd auth token

# Print structured JSON with token and expiration time
azd auth token --output json
```

The default output is the raw token string, making it easy to capture in scripts:

```bash
TOKEN=$(azd auth token)
curl -H "Authorization: Bearer $TOKEN" https://management.azure.com/subscriptions?api-version=2022-12-01
```

Use `--output json` when you also need the token's expiration time:

```json
{
"token": "<access_token>",
"expiresOn": "2024-01-01T00:00:00Z"
}
```

## Problem

As part of its operation, `azd` needs to make calls to different Azure services. For example `azd provision` calls the ARM control plane to submit a deployment. `azd deploy` may need to make management or data plane calls to deploy the customer code that it has built.
Expand Down
13 changes: 13 additions & 0 deletions cli/azd/docs/proxy-configuration.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,3 +30,16 @@ export HTTPS_PROXY=<PROXY_ADDRESS>
Per Go `net/http` package docs

> DefaultTransport is the default implementation of Transport and is used by DefaultClient. It establishes network connections as needed and caches them for reuse by subsequent calls. It uses HTTP proxies as directed by the environment variables HTTP_PROXY, HTTPS_PROXY and NO_PROXY (or the lowercase versions thereof).

## Docker Build Network

If your Docker builds require access to a network proxy or need host networking (for example, to resolve dependencies through a corporate proxy during `docker build`), you can configure the Docker network mode for a service in `azure.yaml`:

```yaml
services:
web:
docker:
network: host
```

The `network` field maps to the `--network` flag of `docker build`. Common values are `host` (use the host's network stack) or `bridge` (default Docker bridge network). This is particularly useful when building containers in environments where internet access is only available through the host network.