Cloud native use of Docker to deploy Teedy lightweight document management system
1. Introduction to Teedy
1.1 Introduction to Teedy
Teedy is an open source, feature-rich, easy-to-use and customizable document management tool that helps users manage and organize documents and is suitable for individuals, groups and organizations.
1.2 Teedy features
-
Create and edit documents: Users can create and edit documents using Markdown format, and can also add tags and comments.
-
File upload and management: Users can upload and manage documents, images and other files.
-
Search and filter: Teedy supports keyword search and tag filtering, allowing users to quickly find the documents they need.
-
Sharing and collaboration: Users can share documents with others and set permissions and sharing links.
-
Interface customization: Teedy provides a variety of themes and layouts that users can customize according to their preferences.
-
Security and privacy protection: Teedy supports security and privacy protection functions such as SSL encryption, user authentication, and database encryption.
2. Introduction to local environment
2.1 Local environment planning
This practice is a personal test environment, and the operating system version is centos7.6.
hostname | IP address | Operating system version | Docker version |
---|---|---|---|
jeven | 192.168.3.166 | centos 7.6 | 20.10.17 |
2.2 Introduction to this practice
1. The deployment environment for this practice is a personal test environment, please be cautious about the production environment;
2. Successfully deployed the Teedy document management tool in the Docker environment.
3. Local environment inspection
3.1 Check Docker service status
Check whether the Docker service is running normally and ensure that Docker is running normally.
[root@jeven ~]# systemctl status docker
● docker.service - Docker Application Container Engine
Loaded: loaded (/usr/lib/systemd/system/docker.service; enabled; vendor preset: disabled)
Active: active (running) since Thu 2023-09-14 20:42:18 CST; 10h ago
Docs: https://docs.docker.com
Main PID: 11576 (dockerd)
Tasks: 51
Memory: 104.7M
CGroup: /system.slice/docker.service
3.2 Check Docker version
Check Docker version
[root@jeven ~]# docker version
Client: Docker Engine - Community
Version: 20.10.17
API version: 1.41
Go version: go1.17.11
Git commit: 100c701
Built: Mon Jun 6 23:05:12 2022
OS/Arch: linux/amd64
Context: default
Experimental: true
Server: Docker Engine - Community
Engine:
Version: 20.10.17
API version: 1.41 (minimum version 1.12)
Go version: go1.17.11
Git commit: a89b842
Built: Mon Jun 6 23:03:33 2022
OS/Arch: linux/amd64
Experimental: false
containerd:
Version: 1.6.6
GitCommit: 10c12954828e7c7c9b6e0ea9b0c02b01407d3ae1
runc:
Version: 1.1.2
GitCommit: v1.1.2-0-ga916309
docker-init:
Version: 0.19.0
GitCommit: de40ad0
3.3 Check docker compose version
Check the Docker compose version to make sure it is above 2.0.
[[root@jeven ~]# docker compose version
Docker Compose version v2.19.1
4. Download the Teedy image
Download the Teedy image from docker hub.
[root@jeven ~]# docker pull sismics/docs
Using default tag: latest
latest: Pulling from sismics/docs
c5cc0d8681c1: Pull complete
25992ae88689: Pull complete
92b293e28b63: Pull complete
5e97fb8c1b1b: Pull complete
e89d6de98e44: Pull complete
9181ab0a3cc7: Pull complete
986d85dbde77: Pull complete
ff6f9607eef5: Pull complete
e1f18d97e35f: Pull complete
5827635e4d0f: Pull complete
3a2abf46fbbe: Pull complete
e2d1dd553bca: Pull complete
d64ca9609368: Pull complete
57b31095515c: Pull complete
afd0e1b54580: Pull complete
d4dc52236c92: Pull complete
df51b630111c: Pull complete
b7f71ce56e9d: Pull complete
aabd4c468f60: Pull complete
9a77c3212377: Pull complete
Digest: sha256:e86804e995a0be52ee81231bfcbeb8b7003a15fd5dc24b300e23f498850d9aa2
Status: Downloaded newer image for sismics/docs:latest
docker.io/sismics/docs:latest
5. Deploy Teedy lightweight document management system
5.1 Create mounting directory
Create a new mounting directory/data/teedy/data
mkdir -p /data/teedy/data && cd /data/teedy
5.2 Create Teedy container
Use docker-cli to quickly create Teedy containers.
docker run -d \
--restart always \
-p 8980:8080 \
-e DOCS_BASE_URL=http://192.168.3.166:898 \
-e DOCS_ADMIN_EMAIL_INIT=[email protected] \
-e DOCS_ADMIN_PASSWORD_INIT=$$2a$$05$$PcMNUbJvsk7QHFSfEIDaIOjk1VI9/E7IPjTKx.jkjPxkx2EOKSoPS \
-v /data/teedy/data:/data \
--name Teedy \
sismics/docs
5.3 View Teedy container status
View Teedy container status
[root@jeven data]# docker ps
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
79e2bcd0515a sismics/docs "bin/jetty.sh run" 15 seconds ago Up 14 seconds 0.0.0.0:8980->8080/tcp, :::8980->8080/tcp Teedy
5.4 Check container running logs
Check the teedy container running log to ensure that the teedy service starts normally.
docker logs Teedy
6. Visit Teedy
6.1 Enter the Teedy login page
Access address: http://192.168.3.166:8980/#/login, replace the IP address with your own server IP address.
6.2 Visit Teedy homepage
Default username and password admin/admin
7. Basic use of Teedy
7.1 Set the default language for documents
Click Settings in the upper right corner - General Settings - Default language for new documents - Simplified Chinese.
7.2 User management
Settings - Users, enter the user management page, where you can create new users, modify user passwords and other operations.
7.3 Add documents
Click Add Document on the left side of the homepage to edit document information.
7.4 Upload files
Click the Add Files option on the right.
7.5 Add uploaded files to new document
Add uploaded files to a new document.
7.6 View files
Click on the file to browse the file content online.