mirror of
https://github.com/mattermost/mattermost.git
synced 2026-10-14 02:24:33 +08:00
docs: delete Azure AKS deployment guide page
The page's screenshots never made it into the monorepo during migration and don't exist under any known source (docs, docs-experimental, or mattermost-developer-documentation). Remove the page rather than ship broken images; drop it from the PDF book manifest and repoint its legacy redirect to the general Kubernetes deployment guide accordingly. Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
Eva Sarafianou
@@ -1,97 +0,0 @@
|
||||
---
|
||||
title: "Deploy Mattermost on Azure Kubernetes Service (AKS)"
|
||||
sidebar_label: "Deploy on AKS (Azure)"
|
||||
---
|
||||
You can use a supported [Azure Marketplace Container Offer](https://azuremarketplace.microsoft.com/en-us/marketplace/apps/mattermost.mattermost-operator) to install Mattermost on your existing Azure infrastructure.
|
||||
|
||||
Before deploying, make sure you have the following:
|
||||
|
||||
- **An AKS cluster**: with the [Application Gateway Ingress Controller (AGIC) add-on](https://learn.microsoft.com/en-us/azure/application-gateway/tutorial-ingress-controller-add-on-new) enabled or another Ingress controller deployed.
|
||||
- **PostgreSQL v13.0+ database**: [Azure Database for PostgreSQL - Flexible Server with Private Access](https://learn.microsoft.com/en-us/azure/postgresql/) is recommended. Deploy one by following [this Microsoft quick start guide](https://learn.microsoft.com/en-us/azure/postgresql/flexible-server/quickstart-create-server-portal).
|
||||
- **Private Network Connectivity**: Verify that there is network connectivity between your AKS cluster and the PostgreSQL database.
|
||||
- **Valid DNS name and TLS certificate**: You must have access to a DNS zone and provide a valid TLS key and certificate for the Ingress Controller.
|
||||
- **Node Capacity**: At least 2 AKS nodes for high availability when deploying for 100 users or more.
|
||||
- **License Key**: Trial or Enterprise license to test high availability and other Enterprise features.
|
||||
|
||||
# Installation steps
|
||||
|
||||
The installation process includes deploying Mattermost and updating the server.
|
||||
|
||||
## Step 1: Deploy Mattermost
|
||||
|
||||
1. Deploy Mattermost from the [Azure Marketplace Container Offer](https://azuremarketplace.microsoft.com/en-us/marketplace/apps/mattermost.mattermost-operator) and select **Get it now**.
|
||||
|
||||
> Alternatively, you can go to the `Extensions + Applications` section of your AKS cluster and install the Mattermost offering from there. Visit the [Microsoft cluster extensions documentation](https://learn.microsoft.com/en-gb/azure/aks/cluster-extensions?tabs=azure-cli) to learn more.
|
||||
|
||||
2. Choose the **Resource Group** and the **Region** of your installed AKS and PostgreSQL database.
|
||||
|
||||
> 
|
||||
|
||||
3. Choose your AKS cluster.
|
||||
|
||||
> 
|
||||
|
||||
4. Fill in the details for your PostgreSQL database. Ensure the user specified has full access.
|
||||
|
||||
> 
|
||||
|
||||
5. Specify Deployment Details including Deployment Name and Deployment Size. You will need to configure file storage for your Mattermost instance. We recommend using an S3-compatible storage service or an NFS-compatible server.
|
||||
|
||||
> 
|
||||
|
||||
6. Configure Mattermost installation hostname and Ingress details. The AGIC add-on is used in the following example to show the ingress annotations required.
|
||||
|
||||
> You can use any pre-installed Ingress Controller in your cluster as long as it supports Kubernetes Ingress and TLS termination.
|
||||
>
|
||||
> ``` yaml
|
||||
> kubernetes.io/ingress.class: azure/application-gateway
|
||||
> appgw.ingress.kubernetes.io/ssl-redirect: "true"
|
||||
> ```
|
||||
|
||||
7. Additionally, we recommend considering:
|
||||
|
||||
> 1. Enforcing a minimum TLS version (e.g., TLS 1.2).
|
||||
> 2. Deploying a Web Application Firewall (WAF) for additional protection, if supported by your ingress controller.
|
||||
> 3. Limiting access using Kubernetes Network Policies.
|
||||
>
|
||||
> 
|
||||
|
||||
8. Ensure that everything is running. You should be able to check the installed plugin from the **AKS Extensions + Applications** page under the **Settings** menu.
|
||||
|
||||
> When the deployment is complete, obtain the hostname or IP address of your Mattermost deployment using the following command:
|
||||
>
|
||||
> ``` sh
|
||||
> kubectl -n mattermost-operator get ingress
|
||||
> ```
|
||||
|
||||
9. Use your IP address from the `ADDRESS` column, and create a DNS record in your domain registration service.
|
||||
10. Access your working Mattermost installation at the URL you’ve determined in your DNS record.
|
||||
|
||||
Learn more about administrating your Mattermost server by visiting the [Administration Guide](/administration-guide/administration-guide-index).
|
||||
|
||||
## Step 2: Upgrade Mattermost via your AKS cluster
|
||||
|
||||
1. Visit the `Extensions + Applications` section of your AKS cluster where your Mattermost installation is deployed.
|
||||
2. You can enable minor version auto upgrades since these are not updating Mattermost version
|
||||
3. Expand the `Configuration Settings` table and add the below configuration and the version you want to install as a value.
|
||||
|
||||
> ```
|
||||
> global.azure.mattermost.version
|
||||
>
|
||||
> .. image:: /_static/images/global-azure-mattermost-version.png
|
||||
> :alt: An example of using custom Mattermost version.
|
||||
> ```
|
||||
|
||||
4. Select **Save** and wait for the upgrade.
|
||||
|
||||
# Looking for a sovereign deployment on Azure Local?
|
||||
|
||||
For organizations requiring on-premises deployments with data sovereignty, **Azure Local** (formerly Azure Stack HCI) provides a hybrid cloud platform that enables you to run Mattermost on-premises while maintaining integration with Microsoft Teams and M365.
|
||||
|
||||
We recommend engaging **Mattermost Professional Services** for Azure Local deployments to ensure optimal configuration and compliance with your security requirements. [Talk to an Expert](https://mattermost.com/contact-sales/) to discuss your Azure Local deployment needs.
|
||||
|
||||
<Important>
|
||||
|
||||
You are responsible for Azure costs associated with any infrastructure you spin up to host a Mattermost server, and Azure credits cannot be applied towards the purchase of a Mattermost license.
|
||||
|
||||
</Important>
|
||||
@@ -23,7 +23,6 @@
|
||||
"/deployment-guide/server/linux/deploy-tar",
|
||||
"/deployment-guide/server/deploy-kubernetes",
|
||||
"/deployment-guide/server/kubernetes/deploy-k8s",
|
||||
"/deployment-guide/server/kubernetes/deploy-k8s-aks",
|
||||
"/deployment-guide/server/kubernetes/deploy-k8s-oke",
|
||||
"/deployment-guide/server/deploy-containers",
|
||||
"/deployment-guide/server/containers/install-docker",
|
||||
|
||||
@@ -1025,7 +1025,7 @@
|
||||
},
|
||||
{
|
||||
"from": "/deploy/server/kubernetes/deploy-k8s-aks",
|
||||
"to": "/deployment-guide/server/kubernetes/deploy-k8s-aks"
|
||||
"to": "/deployment-guide/server/deploy-kubernetes"
|
||||
},
|
||||
{
|
||||
"from": "/deploy/server/kubernetes/deploy-k8s-oke",
|
||||
|
||||
Reference in New Issue
Block a user