Azure Functions samples in Java

This repository contains samples which show the basis usage of Azure Functions in Java.

Contents

Outline the file contents of the repository. It helps users navigate the codebase, build configuration and any related assets.

File/folder Description
src Sample source code.
.gitignore Define what to ignore at commit time.
build.gradle The gradle configuration to this sample.
pom.xml The maven configuration to this sample.
CHANGELOG.md List of changes to the sample.
CONTRIBUTING.md Guidelines for contributing to the sample.
README.md This README file.
LICENSE.txt The license for the sample.

Prerequisites

  • Gradle 4.10+
  • Latest Function Core Tools
  • Azure CLI. This plugin use Azure CLI for authentication, please make sure you have Azure CLI installed and logged in.

Setup

  •   az login
      az account set -s <your subscription id>
    
  • Update the Application settings in Azure portal with the required parameters as below
    • AzureWebJobsStorage: Connection string to your storage account
    • CosmosDBDatabaseName: Cosmos database name. Example: ItemCollectionIn
    • CosmosDBCollectionName:Cosmos database collection name. Example: ItemDb
    • AzureWebJobsCosmosDBConnectionString: Connection string to your Cosmos database
    • AzureWebJobsEventGridOutputBindingTopicUriString: Event Grid URI
    • AzureWebJobsEventGridOutputBindingTopicKeyString: Event Grid string
    • AzureWebJobsEventHubSender, AzureWebJobsEventHubSender_2 : Event hub connection string
    • AzureWebJobsServiceBus: Service bus connection string
    • SBQueueName: Service bus queue name. Example: test-input-java
    • SBTopicName: Service bus topic name. Example: javaworkercitopic2
    • SBTopicSubName: Service bus topic name. Example: javaworkercisub
  • Update host.json with the right extension bundle version. V3 - [1.*, 2.0.0) and V4 - [2.*, 3.0.0)

Running the sample

./mvnw clean package azure-functions:run
./gradlew clean azureFunctionsRun

Deploy the sample on Azure

./mvnw clean package azure-functions:deploy
./gradlew clean azureFunctionsDeploy

NOTE: please replace '/' with '\' when you are running on windows.

Contributing

This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.opensource.microsoft.com.

When you submit a pull request, a CLA bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.

Telemetry

This project collects usage data and sends it to Microsoft to help improve our products and services. Read Microsoft's privacy statement to learn more. If you would like to opt out of sending telemetry data to Microsoft, you can set allowTelemetry to false in the plugin configuration. Please read our document to find more details about allowTelemetry.