クイック スタート: コマンド ラインから Azure で関数を作成する

この記事では、ローカル コマンド ライン ツールを使用して、HTTP 要求に応答する関数を作成します。 コードをローカルで確認したら、Azure Functions のサーバーレス Flex Consumption ホスティング プランにデプロイします。

このクイックスタートを完了すると、ご利用の Azure アカウントでわずかな (数セント未満の) コストが発生します。

必ず、記事の上部にある任意の開発言語を選択してください。

Important

Azure Functionsの Go サポートは現在パブリック プレビュー段階です。 プレビュー期間中、Go 関数アプリは Flex 従量課金プランでのみサポートされます。

Prerequisites

  • 1.24 以降に進む。

  • Azure Functions Core Tools バージョン 4.12 以降。 func --versionを実行して、インストールされているバージョンを確認します。

  • Azure CLI バージョン 2.87.0 以降。 az versionを実行して、インストールされているバージョンを確認します。

  • Rust ツールチェーン (rustup を使用)。 rustc --version コマンドを使用して、現在のバージョンを確認してください。

Azure Functions Core Tools のインストール

Core Tools をインストールするための推奨される方法は、ローカル開発用コンピューターのオペレーティング システムによって異なります。

次の手順で、Windows インストーラー (MSI) を使用して Core Tools v4.x をインストールします。 その他のパッケージベースのインストーラーの詳細については、Core Tools の Readme をご覧ください。

Windows のバージョンに応じて、 以下の Core Tools インストーラーをダウンロードして実行します。

以前に Windows で Windows インストーラー (MSI) を使用して Core Tools をインストールした場合は、最新のバージョンをインストールする前に、[プログラムの追加と削除] から古いバージョンをアンインストールする必要があります。

ヒント

Linux 用 Windows サブシステム (WSL) に Core Tools をインストールするには、[Linux] タブの指示に従います。

仮想環境を作成してアクティブにする

適切なフォルダーで次のコマンドを実行し、.venv という名前の仮想環境を作成してアクティブにします。 Azure Functions でサポートされている Python バージョン のいずれかを使用してください。

python -m venv .venv

source .venv/bin/activate

お使いの Linux ディストリビューションに Python の venv パッケージがインストールされていなかった場合は、次のコマンドを実行します。

sudo apt-get install python3-venv

以降のコマンドはすべて、このアクティブ化された仮想環境で実行します

ローカル コード プロジェクトと関数を作成する

Azure Functions では、コード プロジェクトは、それぞれが特定のトリガーに応答する 1 つ以上の個別の関数を含むアプリです。 プロジェクト内のすべての関数は同じ構成を共有し、ユニットとして Azure にデプロイされます。 このセクションでは、1 つの関数を含むコード プロジェクトを作成します。

  1. func init コマンドを実行して、Go 関数プロジェクトを作成します。

    func init MyGoFunctionApp --worker-runtime go

    このコマンドは、次のファイルを含む MyGoFunctionApp という名前のプロジェクト フォルダーを作成します。

    File Description
    host.json 関数アプリのホスト構成。
    local.settings.json ローカルで実行するときに使用される設定。
    main.go サンプル HTTP によってトリガーされる関数を含むエントリ ポイント。
    go.mod 依存関係管理用の Go モジュール ファイル。
    go.sum Go モジュール チェックサム ファイル。

  2. プロジェクト フォルダーに移動します。

    cd MyGoFunctionApp

  3. main.goを開いて、生成されたコードを確認します。 これには、HTTP によってトリガーされるサンプル関数が含まれています。

    package main

import (
    "log"
    "net/http"

    "github.com/azure/azure-functions-golang-worker/sdk"
    "github.com/azure/azure-functions-golang-worker/worker"
)

// HTTPTriggerHandler handles standard HTTP requests
func HTTPTriggerHandler(w http.ResponseWriter, r *http.Request) {
    log.Printf("Processing HTTP Trigger for %s", r.URL.Path)
    w.WriteHeader(http.StatusOK)
    w.Write([]byte("Hello from Go Worker!"))
}

func main() {
    app := sdk.FunctionApp()
    app.HTTP("hello", HTTPTriggerHandler,
        sdk.WithMethods("GET", "POST"),
        sdk.WithAuth("anonymous"),
    )
    worker.Start(app)
}

    Go 関数では、HTTP トリガーに標準の net/http 型 (http.ResponseWriter と *http.Request) が使用されます。 関数は Go worker SDK と機能オプションを使用して main() に登録され、 function.json ファイルは必要ありません。

  1. ターミナルまたはコマンド プロンプトで、次の func init コマンドを実行して、現在のフォルダーに関数アプリ プロジェクトを作成します。

    func init --worker-runtime dotnet-isolated

  1. ターミナルまたはコマンド プロンプトで、次の func init コマンドを実行して、現在のフォルダーに関数アプリ プロジェクトを作成します。

    func init --worker-runtime node --language javascript

  1. ターミナルまたはコマンド プロンプトで、次の func init コマンドを実行して、現在のフォルダーに関数アプリ プロジェクトを作成します。

    func init --worker-runtime powershell

  1. ターミナルまたはコマンド プロンプトで、次の func init コマンドを実行して、現在のフォルダーに関数アプリ プロジェクトを作成します。

    func init --worker-runtime python

  1. ターミナルまたはコマンド プロンプトで、次の func init コマンドを実行して、現在のフォルダーに関数アプリ プロジェクトを作成します。

    func init --worker-runtime node --language typescript

  1. ターミナルまたはコマンド プロンプトで、次の func init コマンドを実行して、現在のフォルダーに関数アプリ プロジェクトを作成します。

    func init --worker-runtime custom

  1. 空のフォルダーで、次の mvn コマンドを実行して、Azure Functions Maven アーキタイプからコード プロジェクトを生成します。

    mvn archetype:generate -DarchetypeGroupId=com.microsoft.azure -DarchetypeArtifactId=azure-functions-archetype -DjavaVersion=17

    Important

    • Java 11 で関数を実行する場合は、-DjavaVersion=11 を使用します。 詳細については、 Java のバージョンを参照してください。
    • この記事を完了するには、 JAVA_HOME 環境変数を適切なバージョンの JDK のインストール場所に設定します。

  2. Maven により、デプロイ時にプロジェクトの生成を終了するための値の入力が求められます。
    入力を求められたら、次の値を入力します。

    Prompt Value Description
    groupId com.fabrikam Java のパッケージ命名規則に従って、すべてのプロジェクトにわたって対象のプロジェクトを一意に識別する値。
    artifactId fabrikam-functions バージョン番号のない、jar の名前である値。
    version 1.0-SNAPSHOT 既定値を選択します。
    package com.fabrikam 生成された関数コードの Java パッケージである値。 既定値を使用します。

  3. 「Y」と入力するか、Enter キーを押して確認します。

    Maven は 、artifactId という名前の新しいフォルダーにプロジェクト ファイルを作成します。この例では、 fabrikam-functions。

  4. プロジェクト フォルダーに移動します。

    cd fabrikam-functions

    \src\main\java\com\fabrikam プロジェクト ディレクトリのFunction.javaで、新しい HTTP トリガー関数のテンプレートで生成されたコードを確認できます。

  1. 次の func new コマンドを使用して、プロジェクトに関数を追加します。

    func new --name HttpExample --template "HTTP trigger" --authlevel "function"

    新しいコード ファイルがプロジェクトに追加されます。 この場合、 --name 引数は関数の一意の名前 (HttpExample) であり、 --template 引数は HTTP トリガーを指定します。

プロジェクト のルート フォルダーには、local.settings.jsonや host.json という名前の構成ファイルなど、プロジェクトのさまざまなファイルが含 まれています 。 local.settings.json には Azure からダウンロードしたシークレットを含めることができるため、ファイルは既定で .gitignore ファイルのソース管理から除外されます。

関数を作成してビルドする

HTTP トリガー関数は、HttpExample フォルダー内の function.json ファイルで宣言されています。 この関数を完成させるには、ハンドラーを追加し、実行可能ファイルにコンパイルします。

  1. Ctrl + Shift + ` キーを押すか、[ターミナル] メニューの [新しいターミナル] を選択して、新しい統合ターミナルを VS Code で開きます。

  2. 関数アプリのルート (host.json と同じフォルダー) で、handler という名前の Rust プロジェクトを初期化します。

    cargo init --name handler

  3. Cargo.toml に、このクイックスタートを完了するために必要な次の依存関係を追加します。 この例では、warp Web サーバー フレームワークを使用します。

    [dependencies]
warp = "0.3"
tokio = { version = "1", features = ["rt", "macros", "rt-multi-thread"] }

  4. src/main.rs に次のコードを追加して、ファイルを保存します。 これが Rust のカスタム ハンドラーです。

    use std::collections::HashMap;
use std::env;
use std::net::Ipv4Addr;
use warp::{http::Response, Filter};

#[tokio::main]
async fn main() {
    let example1 = warp::get()
        .and(warp::path("api"))
        .and(warp::path("HttpExample"))
        .and(warp::query::<HashMap<String, String>>())
        .map(|p: HashMap<String, String>| match p.get("name") {
            Some(name) => Response::builder().body(format!("Hello, {}. This HTTP triggered function executed successfully.", name)),
            None => Response::builder().body(String::from("This HTTP triggered function executed successfully. Pass a name in the query string for a personalized response.")),
        });

    let port_key = "FUNCTIONS_CUSTOMHANDLER_PORT";
    let port: u16 = match env::var(port_key) {
        Ok(val) => val.parse().expect("Custom Handler port is not a number!"),
        Err(_) => 3000,
    };

    warp::serve(example1).run((Ipv4Addr::LOCALHOST, port)).await
}

  5. カスタム ハンドラーのバイナリをコンパイルします。 関数アプリのルート フォルダーに、handler (Windows の場合は handler.exe) という名前の実行可能ファイルが出力されます。

    cargo build --release
cp target/release/handler .

関数アプリを構成する

関数のホストは、起動時にカスタム ハンドラーのバイナリを実行するよう構成する必要があります。

  1. host.json を開きます。

  2. customHandler.description セクションで、defaultExecutablePath の値を handler に設定します (Windows の場合は handler.exe に設定します)。

  3. customHandler セクションで、enableForwardingHttpRequest という名前のプロパティを追加し、その値を true に設定します。 HTTP トリガーのみで構成される関数の場合、この設定により、カスタム ハンドラーの要求ペイロードではなく、標準的な HTTP 要求を使用できるようになるため、プログラミングが容易になります。

  4. customHandler セクションが次の例のようになっていることを確認します。 ファイルを保存します。

    "customHandler": {
  "description": {
    "defaultExecutablePath": "handler",
    "workingDirectory": "",
    "arguments": []
  },
  "enableForwardingHttpRequest": true
}

この関数アプリは、カスタム ハンドラーの実行可能ファイルを起動するように構成されました。

関数をローカルで実行する

プロジェクトをローカルで実行し、関数エンドポイントを呼び出して、新しい関数を確認します。

  1. 次のコマンドを使用して、プロジェクト フォルダーのルートにあるローカル Azure Functions ランタイム ホストを開始します。

    func start  

    npm install
npm start

    mvn clean package  
mvn azure-functions:run

    出力の末尾には、次の行が表示されます。

     ...

 Now listening on: http://0.0.0.0:7071
 Application started. Press Ctrl+C to shut down.

 Http Functions:

         HttpExample: [GET,POST] http://localhost:7071/api/HttpExample
 ...

    出力の最後に、関数の HTTP エンドポイントが表示されます。

     Functions:

         hello: [GET,POST] http://localhost:7071/api/hello

  2. 関数エンドポイントを呼び出して、機能することを確認します。

    HttpExample関数の URL をこの出力からブラウザーにコピーし、関数の URL を参照します。 "hello world" というメッセージが表示された成功応答を受け取ります。

    Note

    ローカルで実行する場合、アクセス キーの承認は適用されないため、返される関数の URL にはアクセス キーの値が含まれていないため、関数を呼び出すために必要ありません。

    関数がローカルで実行されている状態で、ブラウザーを開き、次の URL に移動します。

    http://localhost:7071/api/hello

    次のような応答が表示されます。

    Hello from Go Worker!

  3. 完了したら、Ctrl+キーを使用し、yを選択して関数ホストを停止します。

関数用の関連 Azure リソースを作成する

関数コードを Azure にデプロイする前に、次のリソースを作成する必要があります。

  • リソース グループ。関連リソースの論理コンテナーです。
  • 既定のストレージ アカウント。関数の状態とその他の情報を維持するために、関数ホストによって使用されます。
  • ユーザーが割り当てたマネージドIDで、Functions ホストが既定のストレージ アカウントに接続します。
  • 関数アプリ。関数コードを実行するための環境となります。 関数アプリは、ローカルの関数プロジェクトと対応関係にあります。これを使用すると、リソースの管理、デプロイ、共有を容易にするための論理ユニットとして関数をグループ化できます。

これらの手順の Azure CLI コマンドを使用して、必要なリソースを作成します。

  1. まだ Azure にサインインしていない場合は、Azure にサインインします。

    az login

    az login コマンドで Azure アカウントにサインインします。 Azure Cloud Shell で実行する場合は、この手順をスキップします。

  2. まだ実行していない場合は、次の az extension add コマンドを使用して Application Insights 拡張機能をインストールします。

    az extension add --name application-insights

  3. 次の az group create コマンドを使用して、選択したリージョンに AzureFunctionsQuickstart-rg という名前のリソース グループを作成します。

    az group create --name "AzureFunctionsQuickstart-rg" --location "<REGION>"

    この例では、 <REGION> を、Flex 従量課金プランをサポートする近くのリージョンに置き換えます。 az functionapp list-flexconsumption-locations コマンドを使用して、現在サポートされているリージョンの一覧を表示します。

  4. 次の az storage account create コマンドを使用して、リソース グループとリージョンに汎用ストレージ アカウントを作成します。

    az storage account create --name <STORAGE_NAME> --location "<REGION>" --resource-group "AzureFunctionsQuickstart-rg" \
--sku "Standard_LRS" --allow-blob-public-access false --allow-shared-key-access false

    この例では、 <STORAGE_NAME> を自分に適した名前に置き換え、Azure Storage で一意の名前に置き換えます。 名前は 3 文字から 24 文字とし、小文字のみを使用する必要があります。 Standard_LRS は汎用アカウントを指定します。これは Functions でサポートされています。 この新しいアカウントには、特定のリソースへのアクセス許可が付与されている Microsoft Entra 認証 ID を使用してのみアクセスできます。

  5. このスクリプトを使用して、ユーザー割り当てマネージド ID を作成し、 jqを使用してオブジェクトの返された JSON プロパティを解析し、既定のストレージ アカウントで Storage Blob Data Owner アクセス許可を付与します。

    output=$(az identity create --name "func-host-storage-user" --resource-group "AzureFunctionsQuickstart-rg" --location <REGION> \
--query "{userId:id, principalId: principalId, clientId: clientId}" -o json)

userId=$(echo $output | jq -r '.userId')
principalId=$(echo $output | jq -r '.principalId')
clientId=$(echo $output | jq -r '.clientId')

storageId=$(az storage account show --resource-group "AzureFunctionsQuickstart-rg" --name <STORAGE_NAME> --query 'id' -o tsv)
az role assignment create --assignee-object-id $principalId --assignee-principal-type ServicePrincipal \
--role "Storage Blob Data Owner" --scope $storageId

    ローカルの Bash シェルに jq ユーティリティがない場合は、Azure Cloud Shell で使用できます。 この例では、 <STORAGE_NAME> と <REGION> をそれぞれ既定のストレージ アカウント名とリージョンに置き換えます。

    az identity create コマンドは、func-host-storage-userという名前の ID を作成します。 返された principalId は、 az role assignment create コマンドを使用して、既定のストレージ アカウントでこの新しい ID にアクセス許可を割り当てるために使用されます。 az storage account show コマンドを使用して、ストレージ アカウント ID を取得します。

  6. 次の az functionapp create コマンドを使用して、Azure で関数アプリを作成します。

    az functionapp create --resource-group "AzureFunctionsQuickstart-rg" --name <APP_NAME> --flexconsumption-location <REGION> \
--runtime dotnet-isolated --runtime-version <LANGUAGE_VERSION> --storage-account <STORAGE_NAME> \
--deployment-storage-auth-type UserAssignedIdentity --deployment-storage-auth-value "func-host-storage-user"

    az functionapp create --resource-group "AzureFunctionsQuickstart-rg" --name <APP_NAME> --flexconsumption-location <REGION> \
--runtime java --runtime-version <LANGUAGE_VERSION> --storage-account <STORAGE_NAME> \
--deployment-storage-auth-type UserAssignedIdentity --deployment-storage-auth-value "func-host-storage-user"

    az functionapp create --resource-group "AzureFunctionsQuickstart-rg" --name <APP_NAME> --flexconsumption-location <REGION> \
--runtime node --runtime-version <LANGUAGE_VERSION> --storage-account <STORAGE_NAME> \
--deployment-storage-auth-type UserAssignedIdentity --deployment-storage-auth-value "func-host-storage-user"

    az functionapp create --resource-group "AzureFunctionsQuickstart-rg" --name <APP_NAME> --flexconsumption-location <REGION> \
--runtime python --runtime-version <LANGUAGE_VERSION> --storage-account <STORAGE_NAME> \
--deployment-storage-auth-type UserAssignedIdentity --deployment-storage-auth-value "func-host-storage-user"

    az functionapp create --resource-group "AzureFunctionsQuickstart-rg" --name <APP_NAME> --flexconsumption-location <REGION> \
--runtime python --runtime-version <LANGUAGE_VERSION> --storage-account <STORAGE_NAME> \
--deployment-storage-auth-type UserAssignedIdentity --deployment-storage-auth-value "func-host-storage-user"

    az functionapp create --resource-group "AzureFunctionsQuickstart-rg" --name <APP_NAME> --flexconsumption-location <REGION> \
--runtime other --storage-account <STORAGE_NAME> \
--deployment-storage-auth-type UserAssignedIdentity --deployment-storage-auth-value "func-host-storage-user"

    この例では、これらのプレースホルダーを適切な値に置き換えます。

    • <APP_NAME>: 自分に適したグローバルに一意の名前。 <APP_NAME> は、関数アプリの既定の DNS ドメインでもあります。
    • <STORAGE_NAME>: 前の手順で使用したアカウントの名前。
    • <REGION>: 現在のリージョン。
    • <LANGUAGE_VERSION>: 必要に応じて、ローカルで確認したのと同じ サポートされている言語スタック バージョン を使用します。

    このコマンドは、 Flex 従量課金プランで Linux 上の指定された言語ランタイムで実行されている関数アプリを作成します。これは、ここで発生する使用量に対して無料です。 このコマンドでは、関連付けられている Azure アプリケーション Insights インスタンスも同じリソース グループに作成されます。このインスタンスを使用して、関数アプリの実行を監視し、ログを表示できます。 詳しくは、「Azure Functions を監視する」をご覧ください。 このインスタンスは、アクティブにするまでコストが発生しません。

  7. このスクリプトを使用して、Application Insights インスタンスの Monitoring Metrics Publisher ロールにユーザー割り当てマネージド ID を追加します。

    appInsights=$(az monitor app-insights component show --resource-group "AzureFunctionsQuickstart-rg" \
    --app <APP_NAME> --query "id" --output tsv)
principalId=$(az identity show --name "func-host-storage-user" --resource-group "AzureFunctionsQuickstart-rg" \
    --query principalId -o tsv)
az role assignment create --role "Monitoring Metrics Publisher" --assignee $principalId --scope $appInsights

    この例では、<APP_NAME> をお使いの関数アプリの名前に置き換えます。 az role assignment create コマンドによって、ユーザーがロールに追加されます。 Application Insights インスタンスのリソース ID とユーザーのプリンシパル ID は、az monitor app-insights コンポーネント show コマンドとaz identity show コマンドをそれぞれ使用して取得されます。

アプリケーション設定を更新する

Functions ホストが共有シークレットを使用して既定のストレージ アカウントに接続できるようにするには、 AzureWebJobsStorage 接続文字列の設定を、プレフィックスとして AzureWebJobsStorage__ で始まるいくつかの設定に置き換えます。 これらの設定は、ユーザー割り当てマネージド ID を使用してストレージと Application Insights に接続するためにアプリが使用する複雑な設定を定義します。

  1. このスクリプトを使用して、ユーザー割り当てマネージド ID のクライアント ID を取得し、それを使用してストレージと Application Insights の両方へのマネージド ID 接続を定義します。

    clientId=$(az identity show --name func-host-storage-user \
    --resource-group AzureFunctionsQuickstart-rg --query 'clientId' -o tsv)
az functionapp config appsettings set --name <APP_NAME> --resource-group "AzureFunctionsQuickstart-rg" \
    --settings AzureWebJobsStorage__accountName=<STORAGE_NAME> \
    AzureWebJobsStorage__credential=managedidentity AzureWebJobsStorage__clientId=$clientId \
    APPLICATIONINSIGHTS_AUTHENTICATION_STRING="ClientId=$clientId;Authorization=AAD"

    このスクリプトでは、 <APP_NAME> と <STORAGE_NAME> をそれぞれ関数アプリとストレージ アカウントの名前に置き換えます。

  2. az functionapp config appsettings delete コマンドを実行して、共有秘密鍵を含む既存のAzureWebJobsStorage接続文字列設定を削除します。

    az functionapp config appsettings delete --name <APP_NAME> --resource-group "AzureFunctionsQuickstart-rg" --setting-names AzureWebJobsStorage

    この例では、 <APP_NAME> を関数アプリの名前に置き換えます。

この時点で、Functions ホストは、共有シークレットではなくマネージド ID を使用して、ストレージ アカウントに安全に接続できます。 これで、プロジェクト コードを Azure リソースにデプロイできるようになりました。

関数用の関連 Azure リソースを作成する

Azureに関数コードをデプロイする前に、リソース グループ、ストレージ アカウント、関数アプリを作成する必要があります。 これらの手順の Azure CLI コマンドを使用して、必要なリソースを作成します。

  1. まだ Azure にサインインしていない場合は、Azure にサインインします。

    az login

    az login コマンドで Azure アカウントにサインインします。 Azure Cloud Shell で実行する場合は、この手順をスキップします。

  2. az group create コマンドを使用して、選択したリージョンに AzureFunctionsQuickstart-rg という名前のリソース グループを作成します。

    az group create --name AzureFunctionsQuickstart-rg --location <REGION>

    この例では、 <REGION> を、Flex 従量課金プランをサポートする近くのリージョンに置き換えます。 az functionapp list-flexconsumption-locations コマンドを使用して、現在サポートされているリージョンの一覧を表示します。

  3. az storage account create コマンドを使用して、リソース グループとリージョンに汎用ストレージ アカウントを作成します。

    az storage account create --name <STORAGE_NAME> --location <REGION> --resource-group AzureFunctionsQuickstart-rg --sku Standard_LRS

    この例では、 <STORAGE_NAME> をグローバルに一意の名前に置き換えます。 名前には 3 ~ 24 文字、小文字と数字のみを含める必要があります。

  4. Azure に関数アプリを作成します。

    az functionapp create --resource-group AzureFunctionsQuickstart-rg --name <APP_NAME> --storage-account <STORAGE_NAME> --flexconsumption-location <REGION> --runtime go --runtime-version 1.0 --functions-version 4

    <APP_NAME>はグローバルに一意の名前に置き換え、<STORAGE_NAME>は前の手順で使用したアカウント名に置き換えます。 また、このコマンドは、関連付けられた Azure アプリケーション Insights インスタンスを同じリソース グループに作成します。これにより、関数アプリを監視し、ログを表示できます。 詳しくは、「Azure Functions を監視する」をご覧ください。

  5. Go パブリック プレビュー中に必要な関数アプリで HTTP/2 を無効にします。

    az resource update --resource-group AzureFunctionsQuickstart-rg --resource-type Microsoft.Web/sites --name <APP_NAME> --set properties.siteConfig.http20Enabled=false

Azure に関数プロジェクトをデプロイする

Azure 内に関数アプリを作成することに成功したら、func azure functionapp publish コマンドを使用してローカル関数プロジェクトをデプロイする準備が整います。

  1. ルート プロジェクト フォルダーで、次の func azure functionapp publish コマンドを実行します。

    func azure functionapp publish <APP_NAME>

    この例では、<APP_NAME> をご自身のアプリの名前に置き換えてください。 デプロイが成功すると、次の出力のような結果 (簡潔にするために切り詰められています) が表示されます。

     ...

 Getting site publishing info...
 Creating archive for current directory...
 Performing remote build for functions project.

 ...

 Deployment successful.
 Remote build succeeded!
 Syncing triggers...
 Functions in msdocs-azurefunctions-qs:
     HttpExample - [httpTrigger]
         Invoke url: https://msdocs-azurefunctions-qs.azurewebsites.net/api/httpexample

  2. ローカル ターミナルまたはコマンド プロンプトで、次のコマンドを実行して、アクセス キーを含む URL エンドポイント値を取得します。

    func azure functionapp list-functions <APP_NAME> --show-keys

    この例では、 <APP_NAME> をアプリの名前に置き換えます。

  3. 関数エンドポイントの呼び出しに使用する、返されたエンドポイント URL とキーをコピーします。

pom.xml ファイルを更新する

Azure で関数アプリを正常に作成したら、Maven が新しいアプリにデプロイできるように、pom.xml ファイルを更新します。 それ以外の場合、Maven はデプロイ時に Azure リソースの新しいセットを作成します。

  1. Azure Cloud Shell で、次の az functionapp show コマンドを使用して、新しいユーザー割り当てマネージド ID のデプロイ コンテナーの URL と ID を取得します。

    az functionapp show --name <APP_NAME> --resource-group AzureFunctionsQuickstart-rg  \
    --query "{userAssignedIdentityResourceId: properties.functionAppConfig.deployment.storage.authentication.userAssignedIdentityResourceId, \
    containerUrl: properties.functionAppConfig.deployment.storage.value}"

    この例では、 <APP_NAME> を関数アプリの名前に置き換えます。

  2. プロジェクトのルート ディレクトリで、テキスト エディターで pom.xml ファイルを開き、 properties 要素を見つけて、次の特定のプロパティ値を更新します。

    プロパティ名 Value
    java.version など、ローカルで確認したのと同じ17を使用します。
    azure.functions.maven.plugin.version 1.37.1
    azure.functions.java.library.version 3.1.0
    functionAppName Azure の関数アプリの名前。

  3. configurationの azure-functions-maven-plugin セクションを見つけて、次の XML フラグメントに置き換えます。

    <configuration>
    <appName>${functionAppName}</appName>
    <resourceGroup>AzureFunctionsQuickstart-rg</resourceGroup>
    <pricingTier>Flex Consumption</pricingTier>
    <region>....</region>
    <runtime>
        <os>linux</os>
        <javaVersion>${java.version}</javaVersion>
    </runtime>
    <deploymentStorageAccount>...</deploymentStorageAccount>
    <deploymentStorageResourceGroup>AzureFunctionsQuickstart-rg</deploymentStorageResourceGroup>
    <deploymentStorageContainer>...</deploymentStorageContainer>
    <storageAuthenticationMethod>UserAssignedIdentity</storageAuthenticationMethod>
    <userAssignedIdentityResourceId>...</userAssignedIdentityResourceId>
    <appSettings>
        <property>
            <name>FUNCTIONS_EXTENSION_VERSION</name>
            <value>~4</value>
        </property>
    </appSettings>
</configuration>

  4. 新しい configuration 要素で、省略記号 (...) の値を次のように置き換えます。

    Configuration Value
    region eastusなど、既存の関数アプリのリージョン コード。
    deploymentStorageAccount ご利用のストレージ アカウントの名前。
    deploymentStorageContainer 展開共有の名前。これは、取得した\値のcontainerUrlの後に付けられます。
    userAssignedIdentityResourceId 取得したマネージド ID の完全修飾リソース ID。

  5. 変更をpom.xml ファイルに保存します。

Maven を使用して、コード プロジェクトを既存のアプリにデプロイできるようになりました。

Azure に関数プロジェクトをデプロイする

  1. コマンド プロンプトで、このコマンドを実行します。

    mvn clean package azure-functions:deploy

  2. デプロイが成功したら、次の Core Tools コマンドを実行して、アクセス キーを含む URL エンドポイント値を取得します。

    func azure functionapp list-functions <APP_NAME> --show-keys

    この例では、 <APP_NAME> をアプリの名前に置き換えます。

  3. 関数エンドポイントの呼び出しに使用する、返されたエンドポイント URL とキーをコピーします。

Azure に関数プロジェクトをデプロイする

Azureで関数アプリを正常に作成したら、ローカル関数プロジェクトをデプロイする準備ができました。 func azure functionapp publish コマンドを使用して、プロジェクトをAzureに配置します。

func azure functionapp publish <APP_NAME>

<APP_NAME> をお使いの関数アプリの名前に置き換えます。

Azure 上の関数を呼び出す

関数は HTTP トリガーを使用し、GET 要求をサポートしているため、関数レベルのアクセス キーを使用して URL への HTTP 要求を行って呼び出します。 ブラウザーで GET 要求を実行するのが最も簡単です。

コピーした URL とアクセス キーをブラウザーのアドレス バーに貼り付けます。

エンドポイント URL は次の例のようになります。

https://contoso-app.azurewebsites.net/api/httpexample?code=aabbccdd...

この場合、エンドポイント URL に対して GET 要求を行うときに、クエリ文字列にアクセス キーを指定する必要もあります。 ランダム クライアントからのアクセスを制限するには、アクセス キーを使用することをお勧めします。 HTTP クライアントを使用して POST 要求を行う場合は、代わりに x-functions-key ヘッダーにアクセス キーを指定する必要があります。

この URL にアクセスすると、この関数をローカルで実行したときと同様の出力がブラウザーに表示されるはずです。

Azure 上の関数を呼び出す

デプロイが完了したら、ブラウザーで次の URL を開き、関数がAzureで実行されていることを確認します。

https://<APP_NAME>.azurewebsites.net/api/hello

関数をローカルで実行したときと同じ Hello from Go Worker! 応答が表示されます。

リソースをクリーンアップする

次の手順に進み、Azure Storage キューの出力バインドを追加する場合は、既に行ったことに基づいて構築するので、すべてのリソースを所定の位置に保持します。

それ以外の場合は、追加コストの発生を避けるために、次のコマンドを使用して、リソース グループとそこに含まれるすべてのリソースを削除してください。

az group delete --name AzureFunctionsQuickstart-rg

リソースをクリーンアップする

次の手順に進む場合は、既に作成したリソースを基にして、すべてのリソースを配置したままにします。

それ以外の場合は、追加コストの発生を避けるために、次のコマンドを使用して、リソース グループとそこに含まれるすべてのリソースを削除してください。

az group delete --name AzureFunctionsQuickstart-rg

次のステップ

Azure Queue Storage へ接続する

次のステップ

Go 開発者向けリファレンス ガイド

Go 関数の開発の詳細については、次のリソースを参照してください。

  • Last updated on