Skip to content

Latest commit

 

History

History
140 lines (78 loc) · 4.62 KB

DEPLOYING.md

File metadata and controls

140 lines (78 loc) · 4.62 KB

Deploying the app

Deploying your app effectively is crucial for making it accessible to users.

  • Using Azure: A powerful option for those who are already integrated into the Microsoft ecosystem or need advanced cloud services. Azure offers robust performance, scalability, and a suite of tools that are beneficial for apps requiring Microsoft-specific integrations or high availability.

The following sections provide a detailed guide on deploying your app using this platform.

Requirements for the app

To deploy your app, you will need:

  1. An active OpenAI account (create here).
  2. An OpenAI API key (create here).

Azure

Recommended configuration:

  • Minimum disk space: 8GB

  • Minimum memory: 4GB

    • If too many users using at the same time, it might need to be higher.

Azure

You can modify the code and deploy the container, or use our default container hosted on ghcr.io.

Using ghcr.io

Prerequisites

Steps

  1. Set Up Azure CLI Login to Azure:

    az login

    This will open a browser window for you to authenticate. Set the Subscription: If you have multiple subscriptions, set the one you wish to use:

    az account set --subscription "your-subscription-id"

    Create a Directory for Your Project:

    mkdir my-terraform-app  
cd my-terraform-app

  2. Use our Terraform Configuration File: Download the terraform configuration file here

    -Modify the variables default field to match your desired resource configuration

     - az_webapp_name (change necessary. Should be unique within Global Azure)

 - az_rg_name (change optional)

 - location (change optional)

 - az_asp_name (change optional)

  3. Initialize Terraform

    terraform init This command downloads the Azure provider and sets up your workspace.

  4. Create an Execution Plan

    Plan the Deployment:

    terraform plan This command creates an execution plan, which lets you preview the changes that Terraform will make to your infrastructure.

  5. Apply the Execution Plan

    Deploy the Resources:

    terraform apply Terraform will prompt you for confirmation before making any changes. Type yes and press Enter.

  6. Verify Deployment

    Check the Resources in Azure Portal: Go to the Azure Portal and verify that the resources have been created.

    Check the deployed URL:

<az_webapp_name>.azurewebsites.net

Environment configuration

To effectively manage user access and configuration settings in your app's deployment environment, here are some key parameters and steps for setting up your environment configuration. This guide covers how to handle these settings in Streamlit Cloud and Azure.

Environment Configuration

  • Hiding the Settings Page

    Use HIDE_SETTINGS=TRUE to conceal the Settings page. This prevents users from altering configurations that could impact the experience for other users.

  • OpenAI API Key

    Set OPENAI_API_KEY="your-key" to ensure secure access to OpenAI services. This key allows interaction with OpenAI's API while keeping it confidential.

  • Authentication

    Enable AUTH_ENABLED=TRUE to restrict app access to authorized users with credentials defined in a .secrets.toml file under the .streamlit directory:

    [passwords]
user_test = "user123"
...

Inserting the secrets.toml file into Web App Deployments (Azure)

When deploying your app on Azure, you may need to configure user credentials as environment variables. Here's how you can accomplish this:

  • User Credentials Environment Variable

    Add credentials in the format user:password, separated by semicolons (;), to your web app's environment variables:

    USER_CREDENTIALS="user1:pwd1;user2:pwd2"

This setup ensures secure handling of user authentication and sensitive configurations across different deployment platforms. By using these configurations, you can maintain control over user access and protect essential settings.