How to configure credentials in Rill
How you configure access to Azure Blob Storage depends on whether you are developing a project locally using
rill start or are setting up a deployment using
Configure credentials for local development
When developing a project locally, Rill uses the credentials configured in your local environment using the Azure CLI (
az). Follow these steps to configure it:
Open a terminal window and run the following command to log in to your Azure account:
Follow the on-screen instructions to complete the login process. This will authenticate you with your Azure account.
If you don't have the Azure CLI installed, you can install it from here.
Once you are logged in, Rill will automatically use the credentials obtained from
az loginto authenticate with Azure Blob Storage when you interact with Azure Blob Storage sources.
Using Connection String
Alternatively, you can use an Azure Blob Storage connection string to configure the credentials. To do this:
Obtain the connection string for your Azure Blob Storage account. You can find this in the Azure Portal under "Access keys" in your storage account settings.
AZURE_STORAGE_CONNECTION_STRINGenvironment variable in your local environment to the connection string value. You can do this in your terminal:
Replace "your_connection_string_here" with your actual connection string.
Rill will automatically use the connection string from the
AZURE_STORAGE_CONNECTION_STRINGenvironment variable to authenticate with Azure Blob Storage when you interact with Azure Blob Storage sources.
Using Shared Access Signature (SAS) Token
Alternatively, you can configure credentials using a Shared Access Signature (SAS) token. To do this:
Generate a SAS token for the Azure Blob Storage container or blob you want to access. You can create SAS tokens using the Azure Portal or programmatically using the Azure SDKs.
AZURE_STORAGE_SAS_TOKENenvironment variable in your local environment to the SAS token value. You can do this in your terminal:
Replace "your_sas_token_here" with your actual SAS token.
Rill will use the SAS token from the
AZURE_STORAGE_SAS_TOKENenvironment variable to authenticate with Azure Blob Storage when interacting with Azure Blob Storage sources.
Configure credentials for deployments on Rill Cloud
When deploying a project to Rill Cloud, Rill requires you to explicitly provide an Azure Blob Storage connection string, Azure Storage Key or Azure Storage SAS token for the Azure Blob Storage containers used in your project.
When you first deploy a project using
rill deploy, you will be prompted to provide credentials for the remote sources in your project that require authentication.
If you subsequently add sources that require new credentials (or if you input the wrong credentials during the initial deploy), you can update the credentials used by Rill Cloud by running:
rill env configure
Note that you must
cd into the Git repository that your project was deployed from before running
rill env configure.