added docs

Author: Francesco Lo Faro

docs/Infra/pipelines/_category_.json

@@ -1,6 +1,6 @@
 {
   "label": "Pipelines",
-  "position": 2,
+  "position": 3,
   "link": {
     "type": "generated-index"
   }

docs/Infra/setup.md

@@ -0,0 +1,49 @@
+---
+sidebar_position: 2
+---
+# Setup
+If it's your first time accessing the infrastructure, you'll need to setup the tools and configure them.
+
+:::caution
+This tutorial assumes your account has the right permissions to access the infrastructure. If not, please contact the team.
+:::
+
+## Azure CLI & Kubectl
+
+- Download and install Kubectl [here](https://kubernetes.io/docs/tasks/tools/install-kubectl/).
+
+- Download and install the Azure CLI [here](https://docs.microsoft.com/en-us/cli/azure/install-azure-cli?view=azure-cli-latest).
+
+- Run ```az login``` to login.
+
+- Run ```az aks get-credentials --resource-group rg-polinetwork --name aks-polinetwork``` to configure Kubectl.
+
+- To check if everything is working, run ```kubectl get pods -n <namespace>```. You should see a list of pods.
+
+:::info
+The possible values of ```<namespace>``` may vary depending on the project you're working on. If you're not sure, ask the team.
+:::
+
+:::danger
+Starting from Kubectl v1.26, the Azure auth plugin has been removed. If you're using a new version, you'll need to install and run [kubelogin](https://github.com/Azure/kubelogin#setup). Then run ```kubectl get pods -n <namespace>``` again.
+:::
+
+
+## Port Forwarding
+To access services running on the cluster (such as the MariaDB database), you'll need to forward the correct ports. To do so, we need the correct pod name.
+
+- Run ```kubectl get pods -n <namespace>``` to get the pod name. The pod name is listed under the ```NAME``` column.
+
+- Run ```kubectl port-forward <pod-name> <local-port>:<remote-port> -n <namespace>```  
+For example, if you want to access the MariaDB database, you'll need to run
+```
+kubectl port-forward <pod-name> 3306:3306 -n <namespace>
+```
+
+:::tip
+If you're using the MariaDB database, you can use the following command to get the pod name and forward the port in one go:  
+```
+PODNAME=$(kubectl get pods --no-headers -n mariadb -o custom-columns=":metadata.name" | tail -1); kubectl port-forward -n mariadb $PODNAME 3306:3306
+```
+You can use the same template to connect to other services.
+:::