Azure / Azure/azure-functions-core-tools

Design: settings story (local.settings.json / .env / app settings)

Open
#5,343 0 comments 0 reactions 0 assignees View on GitHub
design GA v5
Dominant language
C#
Stars
1.5k
Forks
498
Avg merge
5d 4h
Merged PRs (30d)
15

Description

v5 inherits multiple competing settings sources (`local.settings.json`,
`.env`, app settings synced from Azure, CLI config). Design the unified
settings model: precedence, command surface, secret handling, and the
relationship to `az` app settings sync.

## Definition of Done

- [ ] Design doc landed in `docs/proposed/` covering: source precedence,
`func settings` command surface (add / list / delete / encrypt /
decrypt or successor), secret handling, and `.env` support.
- [ ] Decision recorded on whether v5 adopts `.env` as a first-class
source or stays `local.settings.json` only.
- [ ] Decision recorded on how Azure app settings sync works in v5
(`func azure fetch-app-settings` or successor).
- [ ] Follow-up issues opened for each implementation slice.
- [ ] Doc reviewed by host team + at least one PM.

Contributor guide

Open the contributing guide

Research direction

Start with the proposed design document location, docs/proposed/, and use the listed sources—local.settings.json, .env, Azure app settings, and CLI config—as the comparison points. Define the settings model and review the func settings and func azure fetch-app-settings command surfaces named in the issue. Done means the required decisions, follow-up issues, and host-team and PM review are recorded.

Written by the indexing model from the issue text.

Assessment

Tech stack
azure
Domain
cli, cloud
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Quiet
Clarity
Clearly specified
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.