Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/yawl-company/yawlmost

Yawl Mattermost
https://github.com/yawl-company/yawlmost

ansible docker-swarm mattermost vagrant

Last synced: 9 days ago
JSON representation

Yawl Mattermost

Awesome Lists containing this project

README

        

# 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:**
```shell
git clone [email protected]: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:

```shell
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:**
```shell
vagrant up
```

#### Open mattermost
Once the setup is complete, Mattermost will be accessible at `https://mattermost.`.

## 🔧 Development Setup

### 🗂 Setup Environment

Make sure your system has `poetry` and `python3.12` installed

```shell
poetry env use python3
poetry shell
poetry install
```