一、前置知識

在進入具體操作之前，我們需要了解一些背景知識：

1. Docker：Docker 是一個開源的容器化平臺，它允許開發(fā)者將應用程序及其依賴項打包到一個輕量級的容器中，從而使應用程序可以在任何地方一致地運行。
2. Docker Compose：Docker Compose 是一個用于定義和運行多容器 Docker 應用的工具。通過 Docker Compose 文件（通常命名為 docker-compose.yml），可以在一個文件中定義多個服務，并通過一條命令啟動這些服務。
3. One API：One API 是一個 API 網(wǎng)關平臺，它能夠幫助開發(fā)人員更輕松地管理 API 請求，提供統(tǒng)一的 API 接口、請求路由以及安全管理。

二、使用 Docker Compose 部署 One API

在 Docker Compose 中，我們可以定義 One API 服務和其相關的配置。以下是一個典型的 docker-compose.yml 配置：

one-api:
  container_name: one-api
  image: one-api:latest
  restart: always
  command: --log-dir /app/logs
  ports:
    - "3000:3000"
  volumes:
    - ./volumes/one-api/data:/data
    - ./volumes/one-api/logs:/app/logs
    - ./volumes/data-gym-cache:/tmp/data-gym-cache
  environment:
    - SQL_DSN=root:test2024@tcp(111.18.9.111:3306)/oneapi
    - SESSION_SECRET=random_string
    - TZ=Asia/Shanghai
  depends_on:
    mysql:
      condition: service_healthy
  healthcheck:
    test:
      [
        "CMD-SHELL",
        "wget -q -O - http://localhost:3000/api/status | grep -o '\"success\":\\s*true' | awk -F: '{print $2}'",
      ]
    interval: 30s
    timeout: 10s
    retries: 3

以上 docker-compose.yml 文件定義了一個名為 one-api 的服務，并設置了其依賴、端口、環(huán)境變量等配置項。下面我們詳細解析該配置文件的各部分內容。

1. container_name: 設置容器名稱為 one-api，方便通過名字快速識別和管理容器。

2. image: 指定了容器使用的鏡像 one-api:latest，即 One API 的最新版本。

3. restart: 設置為 always，意味著無論容器退出的原因是什么，Docker 都會自動重啟容器，以確保服務的持續(xù)可用性。

4. command: 通過命令 --log-dir /app/logs，將日志目錄指定為 /app/logs。

5. ports: 將主機的 3000 端口映射到容器的 3000 端口，這樣我們可以通過 http://localhost:3000 訪問 One API 服務。

6. volumes: 定義了多個數(shù)據(jù)卷，以便持久化存儲數(shù)據(jù)和日志：

   • ./volumes/one-api/data:/data：將本地 ./volumes/one-api/data 目錄掛載到容器中的 /data 目錄，用于存儲持久化數(shù)據(jù)。
   • ./volumes/one-api/logs:/app/logs：將日志文件掛載到本地 ./volumes/one-api/logs，便于日志管理和分析。
   • ./volumes/data-gym-cache:/tmp/data-gym-cache：將緩存數(shù)據(jù)存放在 ./volumes/data-gym-cache。

7. environment: 定義了幾個環(huán)境變量：

   • SQL_DSN：用于連接數(shù)據(jù)庫的 DSN 配置，格式為 user:password@tcp(host:port)/dbname。
   • SESSION_SECRET：設置會話密鑰，用于加密和驗證會話。
   • TZ：時區(qū)設置為 Asia/Shanghai，確保日志時間等信息符合本地時區(qū)。

8. depends_on: 該配置用于聲明服務之間的依賴關系。例如，One API 依賴于 MySQL 數(shù)據(jù)庫，depends_on 配置確保 MySQL 數(shù)據(jù)庫在 One API 啟動前處于健康狀態(tài)。

9. healthcheck: 定義了健康檢查的命令和時間間隔：

   • test：健康檢查的命令，使用 wget 請求 One API 的狀態(tài)接口，檢測返回結果中是否包含 "success": true。
   • interval、timeout 和 retries 分別設置健康檢查的間隔、超時和重試次數(shù)。

啟動服務

運行以下命令啟動服務：

docker-compose up -d

該命令會在后臺啟動服務，并自動根據(jù) docker-compose.yml 文件中的配置，完成 One API 容器的初始化和啟動。

三、使用 Docker Run 命令直接運行 One API 容器

如果不想使用 Docker Compose，我們還可以使用 docker run 命令來直接啟動 One API 容器：

docker run -d \
  --name one-api \
  --restart always \
  -p 3000:3000 \
  -v $(pwd)/volumes/one-api/data:/data \
  -v $(pwd)/volumes/one-api/logs:/app/logs \
  -v $(pwd)/volumes/data-gym-cache:/tmp/data-gym-cache \
  -e SQL_DSN=root:test2024@tcp(111.18.9.111:3306)/oneapi \
  -e SESSION_SECRET=random_string \
  -e TZ=Asia/Shanghai \
  --health-cmd="wget -q -O - http://localhost:3000/api/status | grep -o '\"success\":\\s*true' | awk -F: '{print $2}'" \
  --health-interval=30s \
  --health-timeout=10s \
  --health-retries=3 \
  one-api:latest \
  --log-dir /app/logs

命令參數(shù)解析

1. -d：表示在后臺運行容器。
2. –name：指定容器的名稱為 one-api。
3. –restart always：設置容器自動重啟。
4. -p 3000:3000：映射端口，與 Docker Compose 配置一致。
5. -v：掛載卷，與 Docker Compose 中的卷配置一致。
6. -e：設置環(huán)境變量。
7. –health-cmd、–health-interval、–health-timeout 和 –health-retries：健康檢查配置。

到此這篇關于在Docker環(huán)境中部署和運行One API的操作方法的文章就介紹到這了,更多相關Docker部署和運行One API內容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章希望大家以后多多支持腳本之家！

最新評論