Azure Functions CLI

What's changed since preview.3

• Fix func new accepting incompatible extension bundles in #5580
• Guard dashboard input with target console capabilities in #5582
• Fix prompt capability checks for redirected consoles in #5581
• Remove unsupported runtimes from SKU built-in profiles in #5507
• refactor: extract focused setup services in #5594
• fix: preserve setup automation and lifecycle contracts in #5604
• Fix RID-specific Host workload package layout in #5614
• Fix v5 installer CDN artifact selection in #5622
• feat(templates): project template parameters with func host metadata in #5665
• feat(templates): list installed templates as func-owned catalog entries in #5667
• feat(update): report updater progress in #5610
• feat(templates): validate raw constraint declarations in #5692
• feat(templates): evaluate validated func constraint requirements in #5698
• feat(init): add metadata-only IProjectStack and installed stack catalog in #5707
• feat(update): add installer-authored installation metadata contract in #5700
• feat(install): emit installation metadata in #5701
• feat(update): wire metadata-gated update command in #5702

New to v5?

This is a preview of the v5 CLI rebuild. See the v5.0.0-preview.1 release notes for the full overview, or jump in below.

⚠️ Preview. Not production-ready, not at v4 feature parity.

Install

PowerShell (Windows, macOS, Linux):

iex "& { $(irm https://aka.ms/func-cli/install.ps1) } -Prerelease"

Bash (macOS, Linux):

curl -sSL https://aka.ms/func-cli/install.sh | bash -s -- --prerelease

You maybe need to run with -Force (pwsh) | --force (bash) if you are upgrading.

Getting started

The CLI ships with just the core commands. Before you can create or run a Functions app, you need to install the workloads for your stack. The easiest way to do that is func setup.

1. Set up your machine

Run func setup on its own to get an interactive multi-select prompt for the stacks you want:

func setup

Prefer non-interactive? Pass the stack directly with --features:

func setup --features dotnet     # .NET
func setup --features node       # Node.js
func setup --features python     # Python
func setup --features go         # Go

2. Create a project

func quickstart                  # complete sample app
# or
func init                        # initalize an empty project

Add individual Function templates via

func new

3. Run it locally

func run

Feedback

File issues at https://github.com/Azure/azure-functions-core-tools/issues and tag with v5.