前言

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

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

是什么

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

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

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

使用介紹

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

啟動(dòng)

假設(shè)腳本的本地運(yùn)行目錄為: /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命令行啟動(dòng):

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

docker-composer啟動(dòng):

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

OK, 此時(shí)訪問請(qǐng)求: http:127.0.0.1/test, 就會(huì)看到返回內(nèi)容return了.

腳本運(yùn)行機(jī)制

路由分配

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

若請(qǐng)求為: /user/change_name.

那么會(huì)將腳本的工作路徑/opt/script(工作路徑通過環(huán)境變量WORKSPACE修改) 與請(qǐng)求拼在一起, 拼接后的路徑為: /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)限.

接收請(qǐng)求

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

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

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

響應(yīng)請(qǐ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

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

配置

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

環(huán)境變量

• WORKSPACE: 修改運(yùn)行腳本的查找目錄. 默認(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運(yùn)行環(huán)境都沒有. 故, 若你有額外需求的話, 有如下兩種方式來實(shí)現(xiàn)系統(tǒng)環(huán)境的定制化:

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

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

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

2. 鏡像引用

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

Dockerfile地址

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

總結(jié)

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

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