https://github.com/heaths/go-dotazure

Load environment variables from Azure Developer CLI environment
https://github.com/heaths/go-dotazure

azd azure-dev dotenv

Last synced: 12 months ago
JSON representation

Load environment variables from Azure Developer CLI environment

• Host: GitHub
• URL: https://github.com/heaths/go-dotazure
• Owner: heaths
• License: mit
• Created: 2025-05-05T05:27:58.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2025-05-07T22:11:49.000Z (about 1 year ago)
• Last Synced: 2025-05-21T02:14:00.395Z (about 1 year ago)
• Topics: azd, azure-dev, dotenv
• Language: Go
• Homepage:
• Size: 16.6 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

          
# Dotazure

[![releases](https://img.shields.io/github/v/release/heaths/go-dotazure.svg?logo=github)](https://github.com/heaths/go-dotazure/releases/latest)

[![reference](https://pkg.go.dev/badge/github.com/heaths/go-dotazure.svg)](https://pkg.go.dev/github.com/heaths/go-dotazure)

[![ci](https://github.com/heaths/go-dotazure/actions/workflows/ci.yml/badge.svg?event=push)](https://github.com/heaths/go-dotazure/actions/workflows/ci.yml)

Locate and load environment variables defined when provisioning an [Azure Developer CLI] project.

## Getting Started

If you do not already have an [Azure Developer CLI] (azd) project, you can create one:

```sh

azd init

```

After you define some resources e.g., an [Azure Key Vault](https://github.com/heaths/go-dotazure/blob/main/infra/resources.bicep),

you can provision those resources which will create a `.env` file with any `output` parameters:

```sh

azd up

```

## Example

After `azd up` provisions resources and creates a `.env` file, you can call `Load()` to load those environment variables

from the default environment e.g.,

```go

package main

import (

    "errors"

    "fmt"

    "os"

    "github.com/heaths/go-dotazure"

)

func main() {

    if loaded, err := dotazure.Load(); err != nil {

        panic(err)

    } else if loaded {

        fmt.Fprintln(os.Stderr, "loaded environment variables")

    }

    // Assumes bicep contains e.g.

    //

    // output AZURE_KEYVAULT_URL string = kv.properties.vaultUri

    vaultURL, _ := os.LookupEnv("AZURE_KEYVAULT_URL")

    fmt.Printf("AZURE_KEYVAULT_URL=%q\n", vaultURL)

}

```

If you want to customize behavior, you can call `Load()` with various `With*` option functions.

## License

Licensed under the [MIT](https://github.com/heaths/go-dotazure/blob/refactor/LICENSE.txt) license.

[Azure Developer CLI]: https://aka.ms/azd