leshkin / wordcloud

Word Cloud is a tool to create a word cloud online from your text and download the resulting image for free.

Word Cloud

WordCloud.online is a tool to create a word cloud online from your text and download the resulting image for free. The words of the text are lemmatized. You can select colors and fonts for the displayed words.

Word cloud for "1984, George Orwell, 1st chapter"

Run locally

1. Run Docker

docker compose -f docker-compose.local.yml up

2. Open http://wordcloud.localhost

Development

1. Run backend

   docker compose -f docker-compose.dev.yml up

2. Run frontend

   cd frontend
   npm run dev

Run application in the development mode using Docker

1. Run

   docker-compose -f docker-compose.dev.yml up

2. Open http://localhost:8080

Install backend to virtual environment

1. Go to backend folder

2. Create virtual environment

   python3 -m venv env

3. Activate venv

   source env/bin/activate

4. Install packages

   pip install -r requirements.txt

Build images

1. Build image for frontend

   cd frontend
   docker build -t 1eshkin/wordcloud-frontend:x.x.x .

2. Push frontend image to the Docker Hub

   docker push 1eshkin/wordcloud-frontend:x.x.x

3. Build image for backend

   cd backend
   docker build -t 1eshkin/wordcloud-backend:x.x.x .

4. Push backend image to the Docker Hub

   docker push 1eshkin/wordcloud-backend:x.x.x

Deploy to Docker Swarm

1. Copy docker-compose.yml to the wordcloud folder on remote server

2. Deploy app to Docker Swarm

   cd wordcloud
   docker stack deploy --compose-file docker-compose.yml wordcloud

Autodeploy with GitHub Actions

Add and push a new tag

git push origin v1.0.0