Expected Duration: 30 minutes
Your goal in this challenge is to create the services necessary to conduct this hackathon. You will deploy the required resources in Azure, including the Azure AI services that will be used in the subsequent challenges. By completing this challenge, you will set up the foundation for the rest of the hackathon.
Azure AI Document Intelligence is an AI service that applies advanced machine learning to extract text, key-value pairs, tables, and structures from documents automatically and accurately. Turn documents into usable data and shift your focus to acting on information rather than compiling it. Start with prebuilt models or create custom models tailored to your documents both on premises and in the cloud with the AI Document Intelligence studio or SDK.
Azure Storage Account
An Azure Storage Account contains all of your Azure Storage data objects: blobs, files, queues, and tables. The storage account provides a unique namespace for your Azure Storage data that's accessible from anywhere in the world over HTTP or HTTPS. Data in your storage account is durable and highly available, secure, and massively scalable.
Azure Cosmos DB is a globally distributed, multi-model database service provided by Microsoft Azure. It is designed to provide low latency, elastic scalability of throughput, well-defined semantics for data consistency, and high availability. Azure Cosmos DB supports multiple data models including key-value, documents, graphs, and columnar. It is a good choice for any serverless application that needs low order-of-millisecond response times and needs to scale rapidly and globally.
Azure Functions is a cloud service available on-demand that provides all the continually updated infrastructure and resources needed to run your applications. You focus on the code that matters most to you, in the most productive language for you, and Functions handles the rest. Functions provides serverless compute for Azure. You can use Functions to build web APIs, respond to database changes, process IoT streams, manage message queues, and more.
Before you start, please fork this repository to your GitHub account by clicking the Fork button in the upper right corner of the repository's main screen (or follow the documentation). This will allow you to make changes to the repository and save your progress.
The first step on this hackathon will be to create the resources we will use throughout the day. Clicking on button bellow will redirect you to the Azure portal to deploy the resources using the ARM template provided in this repository.
NOTE: Deployment may fail if the resource provider Microsoft.AlertsManagement is not registered in your. Follow the documentation to register it and the re-run the deployment.
Resource deployment can take up to 5 minutes. Once the deployment is complete, you will see the resources in your Azure portal.
In the meantime, you can proceed with the next step - opening pre-configured development environment in GitHub Codespaces.
GitHub Codespaces is a cloud-based development environment that allows you to code from anywhere. It provides a fully configured environment that can be launched directly from any GitHub repository, saving you from lengthy setup times. You can access Codespaces from your browser, Visual Studio Code, or the GitHub CLI, making it easy to work from virtually any device.
To open GitHub Codespaces, click on the button below:
Please select your forked repository from the dropdown and, if necessary, adjust other settings of GitHub Codespace.
NOTE: If GitHub Codespaces is not enabled in your organization, you can enable it by following the instructions here, or, if you cannot change your GitHub organization's settings, create free personal GitHub account here.
Go back to your Azure Portal and find your Resource Groupthat should by now contain 9 resources and look like this:
After deploying the resources, you will need to configure the environment variables in the .env file. The .env file is a configuration file that contains the environment variables for the application. The .env file is automatically created running the following command within the terminal in your Codespace:
cd Challenge1
./get-keys.sh --resource-group <resource-group-name>This script will connect to Azure and fetch the necessary keys and populate the .env file with the required values in the root directory of the repository. If needed, script will prompt you to sign in to your Azure account.
When the script is finished, review the .env file to ensure that all the values are correct. If you need to make any changes, you can do so manually.
The default sample has an .env.sample file that shows the relevant environment variables that need to be configured in this project. The script should create a .env file that has these same variables but populated with the right values for your Azure resources.
If the file is not created, simply copy over .env.sample to .env - then populate those values manually from the respective Azure resource pages using the Azure Portal.
By reaching this section you should have every resource and installed the requirements necessary to conduct the hackathon. You have deployed an Azure AI Document Intelligence service, an Azure Cosmos DB account, an Azure Storage Account and Azure OpenAI Service.
In the next challenges, you will use these services to build a strong document processing workflow.