entrypoint.sh：打造高效、可靠的容器啟動腳本

一、入門級使用

entrypoint.sh是一種通用的容器啟動腳本。與Dockerfile中的CMD和ENTRYPOINT命令相比，它具有更高的靈活性和可靠性。

與傳統的啟動腳本不同，entrypoint.sh可以在容器啟動之後執行一些基本的配置，如環境變數驗證、資料庫初始化或文件系統許可權設置。在本初步使用中，entrypoint.sh將被用作啟動服務的腳本。

下面是entrypoint.sh的一個簡單用法：

#!/bin/sh
set -e

# 檢查環境變數
[ -z "$EXAMPLE_ENV_VAR" ] && echo "Missing required environment variable EXAMPLE_ENV_VAR" && exit 1

# 啟動服務
exec /path/to/service --config /path/to/config.json

二、錯誤處理

一個好的entrypoint.sh應該能夠處理錯誤情況。當發生錯誤時，可以在entrypoint.sh中設置一些錯誤處理來對錯誤進行處理，防止錯誤擴散。

例如，假設你的容器需要連接到一個外部資料庫。如果連接失敗，你可以選擇繼續容器的啟動或停止容器。下面是如何處理這種情況：

#!/bin/sh
set -e

# 檢查環境變數
[ -z "$EXAMPLE_ENV_VAR" ] && echo "Missing required environment variable EXAMPLE_ENV_VAR" && exit 1

# 檢查資料庫連接
until nc -z -v -w30 $DATABASE_HOST 5432
do
  echo "Waiting for database connection..."
  # wait for 5 seconds before check again
  sleep 5
done

# 啟動服務
exec /path/to/service --config /path/to/config.json

在此腳本中，你使用`nc`命令等待資料庫連接。如果連接不能在30秒內完成，該腳本將停止啟動服務並退出容器。

三、健康檢查

在進行容器化應用開發時，健康檢查在維護容器的運行狀態時至關重要。可以使用entrypoint.sh來實現容器的健康檢查。

下面是entrypoint.sh的一個常用健康檢查模板：

#!/bin/sh
set -e

# 檢查環境變數
[ -z "$EXAMPLE_ENV_VAR" ] && echo "Missing required environment variable EXAMPLE_ENV_VAR" && exit 1

# 檢查命令
command="$@"

# 定義健康檢查函數
wait_for() {
  if eval "$command"; then
    echo "Service is up"
    return 0
  else
    echo "Service is down"
    return 1
  fi
}

# 進行健康檢查
while ! wait_for; do
  sleep 1s
done

# 啟動服務
exec "$command"

在此腳本中，你使用`wait_for`函數來檢查服務的健康狀況。如果服務正常啟動，該函數將返回`0`。否則，函數將返回`1`，並且循環健康檢查條件將不滿足，直到服務正常啟動。

四、信號處理

是時候考慮應用逐漸變得比較複雜了。當應用程序面臨需要最終清理或關閉的信號時，entrypoint.sh非常有用。例如，在發送信號SIGTERM(15)和SIGKILL(9)之前，可以通過entrypoint.sh停止服務並進行一些清理操作。

#!/bin/sh
set -e

# 初始化配置信息

# 定義信號處理函數
function cleanup {
    echo "Stopping service..."
    # 停止服務
    pkill -INT service
    exit 0
}

# 註冊信號
trap 'cleanup' INT TERM

# 啟動服務
/path/to/service --config /path/to/config.json

在此腳本中，你使用`trap`命令註冊了一個函數`cleanup`，該函數在接收用戶發送的信號SIGTERM或SIGINT時執行。你可以在函數中添加自己的代碼來處理服務停止。

五、結語

entrypoint.sh是一個高度可配置的容器啟動腳本，在容器化應用開發中非常有用。從基本使用到錯誤處理、健康檢查和信號處理，entrypoint.sh可以用來打造高效、可靠的容器啟動腳本。