Yawlmost - Yawl Mattermost Deployment

🔍 Overview

Yawlmost is a deployment project for setting up Mattermost, a powerful open-source messaging platform, using Vagrant.

This project leverages VMware as the provider for creating a robust and scalable environment consisting of manager and worker nodes configured to run in Docker Swarm mode.

📦 Configuration

• Operating System: Ubuntu 20.04 (ARM64)
• Virtual Machines:
  • Leader Node: One primary manager node (manager-1)
  • Manager Nodes: Two additional manager nodes (manager-2, manager-3)
  • Worker Nodes: Two worker nodes (worker-1, worker-2)

🚀 Getting Started

⚙️ Prerequisites

• Vagrant
• Vagrant vmware_desktop provider
• Ansible

🔧 Installation Steps

Clone the repository:

git clone git@github.com:Yawl-Company/yawlmost.git
cd yawlmost/mattermost

Configure Ansible Vault:

1. Edit variables in mattermost/ansible/vault/main.yml.example as needed for your environment

2. Rename the file to main.yml

3. Encrypt the updated file using ansible-vault:

   ansible-vault encrypt mattermost/ansible/vault/main.yml

4. Create ansible/.vault_password file and put your vault password into it

Start the Vagrant environment:

vagrant up

Open mattermost

Once the setup is complete, Mattermost will be accessible at https://mattermost.<vault_domain_name>.

🔧 Development Setup

🗂 Setup Environment

Make sure your system has poetry and python3.12 installed

poetry env use python3
poetry shell
poetry install