前言

兄弟萌, 我實現了一個實用的小工具, 特來分享.

事情剛開始是這樣的, 我需要一個腳本來實現代碼倉庫web hook的任務, 首先想到的是直接調用php, 但是php-fpm是以www-data用戶運行的, 很多調用是無法實現的. 此時, 我就需要一個常駐的偶爾調用一下的, 能夠以root用戶執行的http服務器, 但是網上查了查, 發現并么有符合我要求的現成輪子, 于是它來了.

是什么

簡單介紹一下這個輪子是做什么用的. 簡單說, 就是啟動一個執行shell腳本的http服務.

它啟動一個服務, 來監聽指定端口并響應HTTP請求, 腳本在監聽到新的請求后, 會根據請求路徑調用響應的腳本執行任務并返回對應的內容.

如果需要HTTPS外邊再套一層nginx就行了.

使用介紹

這個破玩意如何使用呢? 為了簡化使用, 我將其打包成了docker鏡像. 注意, 此服務每一次調用會啟動一個新的進程, 故不適用于高并發場景.

啟動

假設腳本的本地運行目錄為: /usr/share/script.

創建文件/usr/share/script/test.bash. 內容如下:

#!/usr/bin/env bashresponse "return"

給腳本賦予執行權限: chmod +x /usr/share/script/test.bash

docker命令行啟動:

docker run -it -d -p 80:80 -v /usr/share/script:/opt/script hujingnb/http_cron

docker-composer啟動:

version: '3.1'services:tcp_cron:build: hujingnb/http_croncontainer_name: http_cronrestart: alwaysport: - 80:80volumes:- /usr/share/script:/opt/script

OK, 此時訪問請求: http:127.0.0.1/test, 就會看到返回內容return了.

腳本運行機制

路由分配

根據請求的request_uri調用對應的腳本.

若請求為: /user/change_name.

那么會將腳本的工作路徑/opt/script(工作路徑通過環境變量WORKSPACE修改) 與請求拼在一起, 拼接后的路徑為: /opt/script/user/change_name, 依次尋找以下后綴文件, 首次找到的為執行腳本:

• /opt/script/user/change_name.pl
• /opt/script/user/change_name.sh
• /opt/script/user/change_name.bash
• /opt/script/user/change_name.php
• /opt/script/user/change_name.py
• /opt/script/user/change_name.rb

若沒有找到腳本, 或訪問根路徑, 返回404.

注意, 所有腳本都需要賦予執行權限.

接收請求

腳本通過環境變量接收請求內容, bash腳本可直接通過$METHOD_TYPE讀取. 有如下內容:

• METHOD_TYPE: 請求的方法. GET POST 等
• HTTP_VERSION: 請求的HTTP版本. HTTP/1.1
• REQUEST_URI: 請求原始路徑(去掉GET參數的).
• QUERY_STR: GET請求的原始參數字符串
• FORM_CONTENT: 若請求是POST, 則此變量保存請求體的字符串內容.
  • 沒有對內容進行解析. 因為根據content-type不同, 解析方式不同. 請自行解析
• QUERY_PARAM_xxx: 解析后的GET請求參數. xxx為參數名
• HEADER_xxx: 請求的 header內容. xxx為header名稱

不同類型腳本讀取系統env環境變量的方式不同, 請自行搜索.

響應請求

通過調用shell命令response進行返回. 如:

#!/usr/bin/env bash# 注意, 腳本在所有輸出之前, 必須先調用 response 命令# status: 響應碼. 默認為 200 # header_: 以 header_ 打頭的參數為響應中添加的 header, 后面跟著 header 名. 可不傳 # 最后的響應內容是必傳參數. 若不需要, 可傳空字符串 response --status=200 --header_ADD_HEADER=TEST "這里存放響應內容" # 以極簡的模式調用. 返回200, 并且沒有響應體 # 若腳本全程沒有審核輸出, 則默認調用 response "" # response ""# 后續的所有 echo 都作為響應內容輸出 echo $QUERY_STR

若是其他腳本請參考調用系統命令的方式, 需要將response的輸出內容寫到標準輸出流.

配置

可通過如下配置進行自定義修改.

環境變量

• WORKSPACE: 修改運行腳本的查找目錄. 默認為: /opt/script.
• LISTEN_PORT: 修改腳本監聽的端口. 默認80

docker命令行通過-e參數添加環境變量

docker-composer通過environment參數修改環境變量

環境準備

為了保證鏡像的大小, 只安裝了必要的軟件, 包括python PHP運行環境都沒有. 故, 若你有額外需求的話, 有如下兩種方式來實現系統環境的定制化:

1.覆蓋/opt/init.bash文件

鏡像在每次啟動時, 都會首先執行/opt/init.bash文件, 可以在這里安裝額外的軟件等初始化操作.

請注意, /opt/init.bash腳本每次鏡像啟動都會執行一次. 此腳本默認不執行任何操作.

2. 鏡像引用

你也可以通過FROM的方式來制作自己的鏡像.

Dockerfile地址

原文鏈接: https://hujingnb.com/archives/729

總結

以上是生活随笔為你收集整理的响应HTTP服务的shell脚本的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。