前言

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

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

是什么

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

它啟動一個服務(wù), 來監(jiān)聽指定端口并響應(yīng)HTTP請求, 腳本在監(jiān)聽到新的請求后, 會根據(jù)請求路徑調(diào)用響應(yīng)的腳本執(zhí)行任務(wù)并返回對應(yīng)的內(nèi)容.

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

使用介紹

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

啟動

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

創(chuàng)建文件/usr/share/script/test.bash. 內(nèi)容如下:

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

給腳本賦予執(zhí)行權(quán)限: 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, 就會看到返回內(nèi)容return了.

腳本運行機(jī)制

路由分配

根據(jù)請求的request_uri調(diào)用對應(yīng)的腳本.

若請求為: /user/change_name.

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

• /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.

注意, 所有腳本都需要賦予執(zhí)行權(quán)限.

接收請求

腳本通過環(huán)境變量接收請求內(nèi)容, bash腳本可直接通過$METHOD_TYPE讀取. 有如下內(nèi)容:

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

不同類型腳本讀取系統(tǒng)env環(huán)境變量的方式不同, 請自行搜索.

響應(yīng)請求

通過調(diào)用shell命令response進(jìn)行返回. 如:

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

若是其他腳本請參考調(diào)用系統(tǒng)命令的方式, 需要將response的輸出內(nèi)容寫到標(biāo)準(zhǔn)輸出流.

配置

可通過如下配置進(jìn)行自定義修改.

環(huán)境變量

• WORKSPACE: 修改運行腳本的查找目錄. 默認(rèn)為: /opt/script.
• LISTEN_PORT: 修改腳本監(jiān)聽的端口. 默認(rèn)80

docker命令行通過-e參數(shù)添加環(huán)境變量

docker-composer通過environment參數(shù)修改環(huán)境變量

環(huán)境準(zhǔn)備

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

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

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

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

2. 鏡像引用

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

Dockerfile地址

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

總結(jié)

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

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯，歡迎將生活随笔推薦給好友。