{"id":58,"date":"2025-01-01T08:48:32","date_gmt":"2025-01-01T03:18:32","guid":{"rendered":"https:\/\/manjunathpr.com\/?p=58"},"modified":"2025-01-01T08:48:32","modified_gmt":"2025-01-01T03:18:32","slug":"how-to-deploy-hasura-on-aca-via-azure-cli","status":"publish","type":"post","link":"https:\/\/manjunathpr.com\/index.php\/2025\/01\/01\/how-to-deploy-hasura-on-aca-via-azure-cli\/","title":{"rendered":"How to – Deploy Hasura on ACA via Azure CLI"},"content":{"rendered":"\n

Hasura, a powerful GraphQL engine, offers documentation on deploying it using Azure Container Instances (ACI)<\/a>, a service that allows you to run containerized applications in the cloud without managing the underlying infrastructure. However, I encountered several challenges during the process, which highlighted the limitations of the existing approach and underscored the need for a more user-friendly and scalable solution. Below are the pain points with the approach<\/p>\n\n\n\n

    \n
  1. The existing documentation requires significant trial and error to execute successfully. <\/li>\n\n\n\n
  2. The provided ARM templates are riddled with issues, making the one-click deployment process unusable.<\/li>\n\n\n\n
  3. ACI does not automatically adjust its resources based on demand. To scale up, you have to delete the container and redeploy, which can be inconvenient.<\/li>\n<\/ol>\n\n\n\n

    To overcome these issues, I found that Azure Container Apps (ACA) offers a better alternative. ACA provides the necessary flexibility while removing the need to deal with complex configurations, such as those in Azure Kubernetes Service (AKS). Here’s a step-by-step guide to deploying Hasura on ACA.<\/p>\n\n\n\n

    \n\n\n\n

    ? Prerequisites<\/strong><\/p>\n\n\n\n

      \n
    1. Azure CLI<\/strong>: Install Azure CLI<\/a> on your machine and log in using an account with sufficient access to create resources.OR<\/strong><\/li>\n\n\n\n
    2. Azure Portal<\/strong>: Log in to portal.azure.com<\/a> and run the Bash shell directly in the portal for a faster and easier setup.<\/li>\n<\/ol>\n\n\n\n
      \n\n\n\n

      ? Deployment Steps<\/strong><\/p>\n\n\n\n

      \u2699\ufe0f Step 1: Register the Resource Provider<\/strong><\/p>\n\n\n\n

      To use Azure Container Apps, you need to first register the Microsoft.ContainerService<\/code> resource provider.<\/p>\n\n\n\n

        \n
      1. Navigate to Subscriptions<\/strong>.<\/li>\n\n\n\n
      2. Select your subscription.<\/li>\n\n\n\n
      3. Go to Resource Providers<\/strong>.<\/li>\n\n\n\n
      4. Search for Microsoft.ContainerService<\/code> and click Register<\/strong>.
        <\/li>\n<\/ol>\n\n\n\n
        \"\"<\/figure>\n\n\n\n
        \n\n\n\n

        ? Step 2: Create a Resource Group<\/strong><\/p>\n\n\n\n

        Run the following command to create a resource group:<\/p>\n\n\n\n

        az group create --name <YOUR_RG_NAME> --location southeastasia<\/code><\/pre>\n\n\n\n
        \n\n\n\n
        ? Step 3: Create an Azure PostgreSQL Flexible Server<\/strong><\/p>\n\n\n\n
        Hasura requires a database to store its configuration. Create a PostgreSQL Flexible Server using the following command:<\/p>\n\n\n\n
        az postgres flexible-server create --resource-group <YOUR_RG_NAME> \\\n   --name \"<YOUR_POSTGRES_DB_SERVER_NAME>\" \\\n   --location southeastasia \\\n   --admin-user <YOUR_POSTGRES_DB_ADMIN_USERNAME> \\\n   --admin-password \"<YOUR_POSTGRES_DB_ADMIN_PWD>\" \\\n   --sku-name standard_b1ms \\\n   --tier Burstable \\\n   --version 16 \\\n   --database-name <YOUR_POSTGRES_DB_NAME><\/code><\/pre>\n\n\n\n
        Enable the database to be accessible by Azure services: This step ensures that Hasura can communicate with the database for storing and retrieving its configuration and operational data.<\/p>\n\n\n\n
        az postgres flexible-server firewall-rule create \\\n   --resource-group <YOUR_RG_NAME> \\\n   --name <YOUR_POSTGRES_DB_SERVER_NAME> \\\n   --rule-name allowazureservices \\\n   --start-ip-address 0.0.0.0 \\\n   --end-ip-address 0.0.0.0<\/code><\/pre>\n\n\n\n
        \n\n\n\n
        ? Step 4: Configure PostgreSQL Server Parameters<\/strong><\/p>\n\n\n\n
          \n
        1. Navigate to your PostgreSQL server in the Azure Portal.<\/li>\n\n\n\n
        2. Go to Server Parameters<\/strong>.<\/li>\n\n\n\n
        3. Search for Extensions<\/strong>.<\/li>\n\n\n\n
        4. Under the azure.extensions<\/code> parameter, set the value to PGCRYPTO<\/code>.<\/li>\n<\/ol>\n\n\n\n
          \"\"<\/figure>\n\n\n\n
          \n\n\n\n
          ? Step 5: Create the Container App Environment<\/strong><\/p>\n\n\n\n
          Create an environment for your container apps:<\/p>\n\n\n\n
          az containerapp env create \\\n  --name <YOUR_ACA_ENV_NAME> \\\n  --resource-group <YOUR_RG_NAME> \\\n  --location southeastasia<\/code><\/pre>\n\n\n\n
          \n\n\n\n
          ? Step 6: Deploy Hasura on ACA<\/strong><\/p>\n\n\n\n
          Finally, create a container app and deploy Hasura. Use the following command:<\/p>\n\n\n\n
          az containerapp create \\\n  --name <YOUR_ACA_APP_NAME> \\\n  --resource-group <YOUR_RG_NAME> \\\n  --environment <YOUR_ACA_ENV_NAME> \\\n  --image hasura\/graphql-engine \\\n  --ingress external \\\n  --target-port 80 \\\n  --env-vars HASURA_GRAPHQL_SERVER_PORT=80 \\\n             HASURA_GRAPHQL_ENABLE_CONSOLE=true \\\n             HASURA_GRAPHQL_ADMIN_SECRET=\"<ADMIN_PASSWORD_THAT_YOU_CAN_REMEMBER>\" \\\n             HASURA_GRAPHQL_METADATA_DATABASE_URL=\"postgres:\/\/<YOUR_POSTGRES_DB_ADMIN_USERNAME>:<YOUR_POSTGRES_DB_ADMIN_PWD>@<YOUR_POSTGRES_DB_SERVER_NAME>.postgres.database.azure.com:5432\/<YOUR_POSTGRES_DB_NAME>?sslmode=require\" \\\n  --min-replicas 1 \\\n  --max-replicas 3<\/code><\/pre>\n\n\n\n
          ? Note<\/strong>: Do not configure the actual DB which Hasura has to run on. This can be done once you deploy Hasura and configure the DB within it.<\/p>\n\n\n\n
          ? Step 7: Verify Deployment<\/strong><\/p>\n\n\n\n
          And that’s it! Hasura will be up and running. To get the URL, run the command below:<\/p>\n\n\n\n
          az containerapp show \\\n  --name <YOUR_ACA_APP_NAME> \\\n  --resource-group <YOUR_RG_NAME> \\\n  --output table<\/code><\/pre>\n\n\n\n
          This will provide you with a table that includes a column called Fqdn<\/code>. That would be the URL for your app\u2014just append \/console<\/code> to access the Hasura Console.
          <\/p>\n\n\n\n
          \"\"<\/figure>\n\n\n\n
          <\/p>\n","protected":false},"excerpt":{"rendered":"
          Hasura, a powerful GraphQL engine, offers documentation on deploying it using Azure Container Instances (ACI), a service that allows you to run containerized applications in the cloud without managing the underlying infrastructure. However, I encountered several challenges during the process, which highlighted the limitations of the existing approach and underscored the need for a more […]<\/p>\n","protected":false},"author":1,"featured_media":68,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_jetpack_memberships_contains_paid_content":false,"footnotes":""},"categories":[3,2,22,5,4,23,21,6],"tags":[8,9,19,10,11,20,18,13],"class_list":["post-58","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-azure","category-cloud-computing","category-container-apps","category-containers","category-devops","category-hasura","category-how-to","category-kubernetes","tag-azure","tag-cloudcomputing","tag-containerapps","tag-containers","tag-devops","tag-graphql","tag-hasura","tag-kubernetes"],"jetpack_featured_media_url":"https:\/\/manjunathpr.com\/wp-content\/uploads\/2025\/01\/aminutetolearn.png","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/manjunathpr.com\/index.php\/wp-json\/wp\/v2\/posts\/58","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/manjunathpr.com\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/manjunathpr.com\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/manjunathpr.com\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/manjunathpr.com\/index.php\/wp-json\/wp\/v2\/comments?post=58"}],"version-history":[{"count":5,"href":"https:\/\/manjunathpr.com\/index.php\/wp-json\/wp\/v2\/posts\/58\/revisions"}],"predecessor-version":[{"id":70,"href":"https:\/\/manjunathpr.com\/index.php\/wp-json\/wp\/v2\/posts\/58\/revisions\/70"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/manjunathpr.com\/index.php\/wp-json\/wp\/v2\/media\/68"}],"wp:attachment":[{"href":"https:\/\/manjunathpr.com\/index.php\/wp-json\/wp\/v2\/media?parent=58"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/manjunathpr.com\/index.php\/wp-json\/wp\/v2\/categories?post=58"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/manjunathpr.com\/index.php\/wp-json\/wp\/v2\/tags?post=58"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}