[HOPSWORKS.AI-DOC] add azure cluster creation

docs/hopsworksai/azure/cluster_creation.md

@@ -0,0 +1,172 @@
+# Getting started with Hopsworks.ai (Azure)
+This guide goes into detail for each of the steps of the cluster creation in Hopsworks.ai
+
+### Step 1 starting to create a cluster
+
+In Hopsworks.ai, select *Create cluster*:
+
+<p align="center">
+  <figure>
+    <a  href="../../../assets/images/hopsworksai/create-instance.png">
+      <img src="../../../assets/images/hopsworksai/create-instance.png" alt="Create a Hopsworks cluster">
+    </a>
+    <figcaption>Create a Hopsworks cluster</figcaption>
+  </figure>
+</p>
+
+### Setp 2 setting the General information
+
+Select the *Location* in which you want your cluster to run (1), name your cluster (2) and select the *Resource Group* (3) in which you want your cluster to run.
+
+Select the *Instance type* (4) and *Local storage* (5) size for the cluster *Head node*.
+
+Select the number of workers you want to start the cluster with (6).
+Select the *Instance type* (7) and *Local storage* size (8) for the *worker nodes*.
+
+!!! note
+    It is possible to add or remove workers once the cluster is running.
+
+To provide the capacity of adding and removing workers on demand, the Hopsworks clusters deployed by Hopsworks.ai store their data in an Azure storage container. In this step, you select which storage account and container to use for this purpose. Enter the name of the *storage account* (9) you want to use in *Azure Storage account name* and name the container in which the data will be stored in *Azure Container name* (10). For more details on how to create and configure a storage in Azure refer to [Creating and configuring a storage](getting_started.md#step-2-creating-and-configuring-a-storage)
+
+!!! note
+    You can choose to use a container already existing in your *storage account* by using the name of this container, but you need to first make sure that this container is empty.
+
+Press *Next* (11):
+
+<p align="center">
+  <figure>
+    <a  href="../../../assets/images/hopsworksai/azure/connect-azure-11.png">
+      <img src="../../../assets/images/hopsworksai/azure/connect-azure-11.png" alt="General configuration">
+    </a>
+    <figcaption>General configuration</figcaption>
+  </figure>
+</p>
+
+### Step 3 select a SSH key
+
+When deploying clusters, Hopsworks.ai installs a ssh key on the cluster's instances so that you can access them if necessary.
+Select the *SSH key* that you want to use to access cluster instances. For more detail on how to add a shh key in Azure refer to [Adding a ssh key to your resource group](getting_started.md#step-3-adding-a-ssh-key-to-your-resource-group)
+
+<p align="center">
+  <figure>
+    <a  href="../../../assets/images/hopsworksai/azure/connect-azure-12.png">
+      <img src="../../../assets/images/hopsworksai/azure/connect-azure-12.png" alt="Choose SSH key">
+    </a>
+    <figcaption>Choose SSH key</figcaption>
+  </figure>
+</p>
+
+### Step 4 select the User assigned managed identity:
+
+In order to let the cluster instances access to the Azure storage we need to attach a *User assigned managed identity* to the virtual machines. In this step you choose which identity to use. This identity need to have access right to the *storage account* you selected in [Step 2](#setp-2-setting-the-general-information)
+Select the *User assigned managed identity* that you created above:
+
+<p align="center">
+  <figure>
+    <a  href="../../../assets/images/hopsworksai/azure/connect-azure-identity.png">
+      <img src="../../../assets/images/hopsworksai/azure/connect-azure-identity.png" alt="Choose the User assigned managed identity">
+    </a>
+    <figcaption>Choose the User assigned managed identity</figcaption>
+  </figure>
+</p>
+
+### Step 5 Virtual network selection
+In this step, you can select the virtual network which will be used by the Hopsworks cluster. You can either select an existing virtual network or let Hopsworks.ai create one for you. If you decide to let Hopsworks.ai create the virtual network for you, you can choose the CIDR block for this virtual network. 
+Refer to [Create a virtual network and subnet](restrictive_permissions.md#step-1-create-a-virtual-network-and-subnet) for more details on how to create your own virtual network in Azure.
+
+<p align="center">
+  <figure>
+    <a  href="../../../assets/images/hopsworksai/azure/connect-azure-13.png">
+      <img src="../../../assets/images/hopsworksai/azure/connect-azure-13.png" alt="Choose virtual network">
+    </a>
+    <figcaption>Choose virtual network</figcaption>
+  </figure>
+</p>
+
+### Step 6 Subnet selection
+If you selected an existing virtual network in the previous step, this step lets you select which subnet of this virtual network to use. For more information about creating your own subnet refer to [Create a virtual network and subnet](restrictive_permissions.md#step-1-create-a-virtual-network-and-subnet).
+
+If you did not select an existing virtual network in the previous step Hopsworks.ai will create the subnet for you. You can choose the CIDR block this subnet will use.
+
+<p align="center">
+  <figure>
+    <a  href="../../../assets/images/hopsworksai/azure/connect-azure-14.png">
+      <img src="../../../assets/images/hopsworksai/azure/connect-azure-14.png" alt="Choose subnet">
+    </a>
+    <figcaption>Choose subnet</figcaption>
+  </figure>
+</p>
+
+### Step 7 Network Security group selection
+In this step, you can select the network security group you want to use to manage the inbound and outbound network rules. You can either let Hopsworks.ai create a network security group for you or select an existing security group. For more information about how to create your own network security group in Azure refer to [Create a network security group](restrictive_permissions.md#step-2-create-a-network-security-group).
+
+<p align="center">
+  <figure>
+    <a  href="../../../assets/images/hopsworksai/azure/connect-azure-15.png">
+      <img src="../../../assets/images/hopsworksai/azure/connect-azure-15.png" alt="Choose security group">
+    </a>
+    <figcaption>Choose security group</figcaption>
+  </figure>
+</p>
+
+### Step 8 User management selection
+In this step, you can choose which user management system to use. You have three choices: 
+
+* *Managed*: Hopsworks.ai automatically adds and removes users from the Hopsworks cluster when you add and remove users from your organization.
+* *LDAP*: integrate the cluster with your organization's LDAP/ActiveDirectory server.
+* *Disabled*: let you manage users manually from within Hopsworks.
+
+<p align="center">
+  <figure>
+    <a  href="../../../assets/images/hopsworksai/azure/connect-azure-16.png">
+      <img src="../../../assets/images/hopsworksai/azure/connect-azure-16.png" alt="Choose user management type">
+    </a>
+    <figcaption>Choose user management type</figcaption>
+  </figure>
+</p>
+
+### Step 9 add tags to your instances.
+In this step, you can define tags that will be added to the cluster virtual machines.
+
+<p align="center">
+  <figure>
+    <a  href="../../../assets/images/hopsworksai/azure/add-tags.png">
+      <img src="../../../assets/images/hopsworksai/azure/add-tags.png" alt="Add tags">
+    </a>
+    <figcaption>Choose user management type</figcaption>
+  </figure>
+</p>
+
+### Step 10 Review and create
+Review all information and select *Create*:
+
+<p align="center">
+  <figure>
+    <a  href="../../../assets/images/hopsworksai/azure/connect-azure-17.png">
+      <img src="../../../assets/images/hopsworksai/azure/connect-azure-17.png" alt="Review cluster information">
+    </a>
+    <figcaption>Review cluster information</figcaption>
+  </figure>
+</p>
+
+The cluster will start. This will take a few minutes:
+
+<p align="center">
+  <figure>
+    <a  href="../../../assets/images/hopsworksai/booting.png">
+      <img src="../../../assets/images/hopsworksai/booting.png" alt="Booting Hopsworks cluster">
+    </a>
+    <figcaption>Booting Hopsworks cluster</figcaption>
+  </figure>
+</p>
+
+As soon as the cluster has started, you will be able to log in to your new Hopsworks cluster with the username and password provided. You will also able to stop, restart, or terminate the cluster.
+
+<p align="center">
+  <figure>
+    <a  href="../../../assets/images/hopsworksai/running.png">
+      <img src="../../../assets/images/hopsworksai/running.png" alt="Running Hopsworks cluster">
+    </a>
+    <figcaption>Running Hopsworks cluster</figcaption>
+  </figure>
+</p>

docs/hopsworksai/azure/getting_started.md

@@ -339,7 +339,7 @@ Select the *Instance type* (7) and *Local storage* size (8) for the *worker node
 Enter the name of the *storage account* (9) you created above in *Azure Storage account name* and name the container in which the data wil be stored in *Azure Container name* (10).
 
 !!! note
-    You can choose to use a container already existing in you *storage account* by using the name of this container, but you need to fist make sure that this container is empty.
+    You can choose to use a container already existing in your *storage account* by using the name of this container, but you need to first make sure that this container is empty.
 
 Press *Next* (11):
 

mkdocs.yml

@@ -18,6 +18,8 @@ nav:
     - Limiting Permissions: 
       - AWS: hopsworksai/aws/restrictive_permissions.md
       - Azure: hopsworksai/azure/restrictive_permissions.md
+    - Cluster creation:
+      - Azure: hopsworksai/azure/cluster_creation.md
     # - Databricks Quickstart:
     #  - AWS: hopsworksai/aws/databricks_quickstart.md
     #  - Azure: hopsworksai/azure/databricks_quickstart.md