Skip to content

Commit

Permalink
[azure-docs] docs on setting up AKS agent
Browse files Browse the repository at this point in the history
  • Loading branch information
dpeng817 committed Nov 27, 2024
1 parent f4b793c commit 065ba2a
Show file tree
Hide file tree
Showing 3 changed files with 60 additions and 0 deletions.
10 changes: 10 additions & 0 deletions docs/content/_navigation.json
Original file line number Diff line number Diff line change
Expand Up @@ -548,6 +548,16 @@
{
"title": "Setting environment variables",
"path": "/dagster-plus/managing-deployments/setting-environment-variables-agents"
},
{
"title": "Deploying on Azure: Full guide",
"path": "/dagster-plus/deployment/azure/overview",
"children": [
{
"title": "Part 1: Setting up an AKS agent.",
"path": "/dagster-plus/deployment/azure/aks-agent"
}
]
}
]
}
Expand Down
40 changes: 40 additions & 0 deletions docs/content/dagster-plus/deployment/azure/aks-agent.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,40 @@
# Dagster+ on Azure - Quickstart Guide

This guide will walk you through deploying a Dagster+ agent on an Azure Kubernetes Service (AKS) cluster.

This guide is intended to be a quickstart, and you should always defer to organization-specific guidelines for creating and managing new infrastructure.

We'll start from a brand new organization in Dagster+, and finish with a full hybrid deployment of Dagster+ using Azure infrastructure.

## Prerequisites

To complete the steps in this guide, you'll need:

- The azure CLI installed on your machine. You can download it [here](https://docs.microsoft.com/en-us/cli/azure/install-azure-cli).
- `kubectl` installed on your machine. You can download it [here](https://kubernetes.io/docs/tasks/tools/install-kubectl/).
- `helm` installed on your machine. You can download it [here](https://helm.sh/docs/intro/install/).
- An existing AKS cluster. If you need to create a new AKS cluster, refer to the [Azure documentation](https://learn.microsoft.com/en-us/azure/aks/learn/quick-kubernetes-deploy-portal?tabs=azure-cli).
- A Dagster+ organization, with an agent token for that organization.

## Step 1: Generate a Dagster+ agent token.

<GenerateAgentToken />

## Step 2: Log in to your AKS cluster.

We'll use the azure CLI to log in to your AKS cluster. Run the following command and follow the prompts to log in.

```bash
az login
az aks get-credentials --resource-group <your-resource-group> --name <your-aks-cluster>
```

We should now be able to verify our installation by running a command that tells us the current context of our kubectl installation. We'd expect it to output the name of the AKS cluster.

```bash
kubectl config current-context
```

## Step 3: Install the Dagster+ agent on the AKS cluster.

Next, we'll install the agent helm chart. You should be able to follow the guide [here](/concepts/deployment/agents/kubernetes/configuring-running-kubernetes-agent) to install the agent on the AKS cluster.
10 changes: 10 additions & 0 deletions docs/content/dagster-plus/deployment/azure/overview.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
# Deploying Dagster+ hybrid on Azure

This guide will walk you through deploying Dagster+ on Azure. We'll start from a brand new organization in Dagster+, and finish with a full hybrid deployment of Dagster+ using Azure infrastructure.

<ArticleList>
<ArticleListItem
title="Step 1: Deploy an Azure Kubernetes Service (AKS) agent"
href="/dagster-plus/deployment/azure/aks-agent"
></ArticleListItem>
</ArticleList>

0 comments on commit 065ba2a

Please sign in to comment.