azure-functions-core-tools
Advanced tools
Comparing version 4.0.4483 to 4.0.4544
{ | ||
"name": "azure-functions-core-tools", | ||
"version": "4.0.4483", | ||
"version": "4.0.4544", | ||
"lockfileVersion": 2, | ||
@@ -9,3 +9,3 @@ "requires": true, | ||
"name": "azure-functions-core-tools", | ||
"version": "4.0.4483", | ||
"version": "4.0.4544", | ||
"hasInstallScript": true, | ||
@@ -12,0 +12,0 @@ "license": "MIT", |
{ | ||
"name": "azure-functions-core-tools", | ||
"version": "4.0.4483", | ||
"version": "4.0.4544", | ||
"description": "Azure Functions Core Tools", | ||
@@ -5,0 +5,0 @@ "scripts": { |
155
README.md
@@ -5,3 +5,4 @@ ![Azure Functions Logo](https://raw.githubusercontent.com/Azure/azure-functions-cli/master/src/Azure.Functions.Cli/npm/assets/azure-functions-logo-color-raster.png) | ||
|---|---| | ||
|master|[![Build Status](https://azfunc.visualstudio.com/Azure%20Functions/_apis/build/status/azure-functions-core-tools?branchName=master)](https://azfunc.visualstudio.com/Azure%20Functions/_build/latest?definitionId=11&branchName=master) | ||
|v4.x|[![Build status](https://azfunc.visualstudio.com/Azure%20Functions/_apis/build/status/azure-functions-core-tools?branchName=v4.x)](https://azfunc.visualstudio.com/Azure%20Functions/_build/latest?definitionId=11&branchName=v4.x)| | ||
|v3.x|[![Build status](https://azfunc.visualstudio.com/Azure%20Functions/_apis/build/status/azure-functions-core-tools?branchName=v3.x)](https://azfunc.visualstudio.com/Azure%20Functions/_build/latest?definitionId=11&branchName=v3.x)| | ||
|dev|[![Build Status](https://azfunc.visualstudio.com/Azure%20Functions/_apis/build/status/azure-functions-core-tools?branchName=dev)](https://azfunc.visualstudio.com/Azure%20Functions/_build/latest?definitionId=11&branchName=dev) | ||
@@ -18,6 +19,8 @@ |v1.x|[![Build status](https://azfunc.visualstudio.com/Azure%20Functions/_apis/build/status/azure-functions-core-tools?branchName=v1.x)](https://azfunc.visualstudio.com/Azure%20Functions/_build/latest?definitionId=11&branchName=v1.x)| | ||
**v2** (master branch): Self-contained cross-platform package | ||
**v2** (dev branch): Self-contained cross-platform package | ||
**v3**: Self-contained cross-platform package | ||
**v3**: (v3.x branch): Self-contained cross-platform package | ||
**v4**: (v4.x branch): Self-contained cross-platform package **(recommended)** | ||
## Installing | ||
@@ -27,10 +30,22 @@ | ||
To install runtime with npm: | ||
#### To download and install with MSI: | ||
**v2** | ||
##### v4 | ||
- [Windows 64-bit](https://go.microsoft.com/fwlink/?linkid=2174087) (VS Code debugging requires 64-bit) | ||
- [Windows 32-bit](https://go.microsoft.com/fwlink/?linkid=2174159) | ||
##### v3 | ||
- [Windows 64-bit](https://go.microsoft.com/fwlink/?linkid=2135274) (VS Code debugging requires 64-bit) | ||
- [Windows 32-bit](https://go.microsoft.com/fwlink/?linkid=2135275) | ||
#### To install with npm: | ||
##### v4 | ||
```bash | ||
npm i -g azure-functions-core-tools@2 --unsafe-perm true | ||
npm i -g azure-functions-core-tools@4 --unsafe-perm true | ||
``` | ||
**v3** | ||
##### v3 | ||
```bash | ||
@@ -40,4 +55,10 @@ npm i -g azure-functions-core-tools@3 --unsafe-perm true | ||
To install with chocolatey: | ||
##### v2 | ||
```bash | ||
npm i -g azure-functions-core-tools@2 --unsafe-perm true | ||
``` | ||
#### To install with chocolatey: | ||
##### v4 | ||
```bash | ||
@@ -47,13 +68,43 @@ choco install azure-functions-core-tools | ||
##### v3 | ||
```bash | ||
choco install azure-functions-core-tools-3 | ||
``` | ||
*Notice: To debug functions under vscode, the 64-bit version is required* | ||
```bash | ||
choco install azure-functions-core-tools-3 --params "'/x64'" | ||
``` | ||
##### v2 | ||
```bash | ||
choco install azure-functions-core-tools-2 | ||
``` | ||
#### To install with winget: | ||
##### v4 | ||
```bash | ||
winget install Microsoft.AzureFunctionsCoreTools | ||
``` | ||
##### v3 | ||
```bash | ||
winget install Microsoft.AzureFunctionsCoreTools -v 3.0.3904 | ||
``` | ||
### Mac | ||
**Homebrew**: | ||
#### Homebrew: | ||
**v2** | ||
##### v4 | ||
```bash | ||
brew tap azure/functions | ||
brew install azure-functions-core-tools@2 | ||
brew install azure-functions-core-tools@4 | ||
``` | ||
**v3** | ||
##### v3 | ||
```bash | ||
@@ -64,4 +115,10 @@ brew tap azure/functions | ||
Homebrew allow side by side installation of v2 and v3, you can switch between the versions using | ||
##### v2 | ||
```bash | ||
brew tap azure/functions | ||
brew install azure-functions-core-tools@2 | ||
``` | ||
Homebrew allows side by side installation of v2 and v3, you can switch between the versions using | ||
```bash | ||
brew link --overwrite azure-functions-core-tools@3 | ||
@@ -73,6 +130,10 @@ ``` | ||
#### Ubuntu | ||
#### 1. Set up package feed | ||
1. Set up package feed | ||
##### Ubuntu 20.04 | ||
```bash | ||
wget -q https://packages.microsoft.com/config/ubuntu/20.04/packages-microsoft-prod.deb | ||
sudo dpkg -i packages-microsoft-prod.deb | ||
``` | ||
@@ -107,8 +168,11 @@ ##### Ubuntu 19.04 | ||
##### Debian 9 | ||
##### Debian 9 / 10 | ||
```bash | ||
# set to 9 or 10 | ||
DEBIAN_VERSION=10 | ||
wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > microsoft.asc.gpg | ||
sudo mv microsoft.asc.gpg /etc/apt/trusted.gpg.d/ | ||
wget -q https://packages.microsoft.com/config/debian/9/prod.list | ||
wget -q https://packages.microsoft.com/config/debian/$DEBIAN_VERSION/prod.list | ||
sudo mv prod.list /etc/apt/sources.list.d/microsoft-prod.list | ||
@@ -119,9 +183,22 @@ sudo chown root:root /etc/apt/trusted.gpg.d/microsoft.asc.gpg | ||
2. Install | ||
#### 2. Install | ||
##### v4 | ||
```bash | ||
sudo apt-get update | ||
sudo apt-get install azure-functions-core-tools | ||
sudo apt-get install azure-functions-core-tools-4 | ||
``` | ||
##### v3 | ||
```bash | ||
sudo apt-get update | ||
sudo apt-get install azure-functions-core-tools-3 | ||
``` | ||
##### v2 | ||
```bash | ||
sudo apt-get update | ||
sudo apt-get install azure-functions-core-tools-2 | ||
``` | ||
#### Other Linux Distributions | ||
@@ -131,30 +208,31 @@ | ||
Download the latest release for your platform from [here](https://github.com/Azure/azure-functions-core-tools/releases). | ||
Download the latest release for your platform from [here](https://github.com/Azure/azure-functions-core-tools/releases). | ||
2. Unzip release zip | ||
Using your preferred tool, unzip the downloaded release. To unzip into an `azure-functions-cli` directory using the `unzip` tool, run this command from the directory containing the downloaded release zip: | ||
Using your preferred tool, unzip the downloaded release. To unzip into an `azure-functions-cli` directory using the `unzip` tool, run this command from the directory containing the downloaded release zip: | ||
```bash | ||
unzip -d azure-functions-cli Azure.Functions.Cli.linux-x64.*.zip | ||
``` | ||
```bash | ||
unzip -d azure-functions-cli Azure.Functions.Cli.linux-x64.*.zip | ||
``` | ||
3. Make the `func` command executable | ||
Zip files do not maintain the executable bit on binaries. So, you'll need to make the `func` binary executable. Assuming you used the instructions above to unzip: | ||
Zip files do not maintain the executable bit on binaries. So, you'll need to make the `func` binary, as well as `gozip` (used by func during packaging) executables. Assuming you used the instructions above to unzip: | ||
```bash | ||
cd azure-functions-cli | ||
chmod +x func | ||
./func | ||
``` | ||
```bash | ||
cd azure-functions-cli | ||
chmod +x func | ||
chmod +x gozip | ||
./func | ||
``` | ||
4. Optionally add `func` to your `$PATH` | ||
To execute the `func` command without specifying the full path to the binary, add its directory to your `$PATH` environment variable. Assuming you're still following along from above: | ||
To execute the `func` command without specifying the full path to the binary, add its directory to your `$PATH` environment variable. Assuming you're still following along from above: | ||
```bash | ||
export PATH=`pwd`:$PATH | ||
func | ||
``` | ||
```bash | ||
export PATH=`pwd`:$PATH | ||
func | ||
``` | ||
@@ -165,5 +243,2 @@ [Code and test Azure Functions locally](https://docs.microsoft.com/en-us/azure/azure-functions/functions-run-local) | ||
**NOTE**: If you're running the v2 on Windows, Linux, or Mac, make sure to [enable the `beta` runtime](https://docs.microsoft.com/en-us/azure/azure-functions/functions-versions#target-the-version-20-runtime) in function app settings, otherwise you may not see the same results as running locally. | ||
## Getting Started on Kubernetes | ||
@@ -216,3 +291,3 @@ | ||
* [Knative](https://github.com/knative/docs/tree/master/install/) | ||
* [Knative](https://github.com/knative/docs/tree/master/docs/install) | ||
@@ -288,3 +363,3 @@ Deploying Azure Functions to knative is supported with the ```--platform knative``` flag. | ||
* [Install VKubelet with ACI](https://github.com/virtual-kubelet/virtual-kubelet/tree/master/providers/azure) | ||
* [Install VKubelet with ACI](https://github.com/virtual-kubelet/azure-aci) | ||
@@ -291,0 +366,0 @@ * [Install VKubelet with ACI on AKS](https://docs.microsoft.com/en-us/cli/azure/aks?view=azure-cli-latest#az-aks-install-connector) |
65006
393