Category: 資訊相關Idea與筆記

Posted on

compodoc

前兩天看到這篇：你寫的文件別人看得懂嗎？：compodoc ，所以想來試試看。

因為想放到 Jenkins 裡去自動產生 Angular App 的文件，所以想用 docker 來避免在 Jenkins 主機上安裝 compodoc 。

首先找到有沒有已經寫好的 docker image，很幸運，找到 sdvplurimedia/lea-pulse-compodoc – Docker Hub ，github repository 在 SDV-Plurimedia/docker-images: DockerFiles public ，從 Dockerfile 可以看出就只是簡單的繼承自 nodejs 的 image ，然後用 yarn 安裝 compodoc。

所以用 docker pull 拉到本地端，就可以用 docker run 來執行了，先看看有什麼參數：

docker run -it sdvplurimedia/lea-pulse-compodoc:latest compodoc --help

然後在專案目錄下建立 doc 目錄，用 docker run 將專案目錄掛載到 /src，輸出目錄掛到 /src/documentation，再執行：

docker run -v ${PWD}:/src -v ${PWD}/doc:/src/documentation -it sdvplurimedia/lea-pulse-compodoc:latest /bin/sh -c 'cd /src && compodoc -p tsconfig.json'

就可以在執行，並在 documentation 目錄裡找到 HTML 文件了。

Posted on

Ansible 處理多主機不同密碼

用 Ansible 一陣子了，比較麻煩的地方是，主機不一定密碼都相同，簡單的方法當然是讓主機密碼都一樣，但這樣就降低了安全性。有沒有不需要改動密碼的方式呢？在網路上找了半天，找到這篇：ubuntu – Ansible: how to run a play with hosts with different passwords? – Stack Overflow ，裏面有個回應是建議使用 group_vars + ansible-vault + ansible_become_user/ansible_become_pass 來解決。

以下紀錄大致的步驟：

  1. 在 playbook 所在目錄或是 /etc/ansible 下建立 group_vars 資料夾 (以下簡稱 group_vars 資料夾)。
  2. 在 inventory 檔案裡，將相同密碼的主機編成一個群組，這裡假設群組名稱是 foo。
  3. 進入 group_vars 資料夾，用 ansible-vault create foo.yml ，這時候會詢問你 vault 的密碼，輸入完成以後，會開啟編輯器，請在裏面輸入 
    ---
ansible_become_user: "root"
ansible_become_pass: "your_password"
  4. 存檔離開編輯器。
  5. 在輸入 ansible-playbook 或 ansible 指令時，帶 –ask-vault-pass 參數，也就是在執行時，會問你 vault 檔案的密碼，然後自動解密並讀入裏面的變數執行。

之後要編輯加密過的檔案，得用 ansible-vault edit foo.yml 才行。

參考資料：

Posted on

Upgrade Jenkins plugins via SSH

之前都是啟用 CLI over remoting ，用 jenkins CLI 做更新，但前一陣子在更新 Jenkins 以後，開始該該叫，說這樣不安全。查了一下文件，發現可以用 SSH 來做。

  1. 在 http://jenkins/configureSecurity 裡啟用 random SSHD Port
  2. 在會使用 ssh 登入更新的使用者設定裡 (http://jenkins/user/YOUR_USER_NAME/configure)，貼上 public key 。
  3. 參考並修改這個腳本，執行它就可以更新了。
Posted on

wordpress 出現 Invalid post type 錯誤

今天進 wordpress ，選 All posts 後，就出現 Invalid post type. 的錯誤。先試著開啟 wordpress wp-admin/edit.php 看，發現一開始的檢查 $typenow 就導致錯誤 了，$typenow 是空的。

根據程式碼，試著在網址列加上 ?post_type=post ，能進入 All posts 了，但文章列表是空的。

  1. 上網找了一些文章，說是要移除 plugin ，但我試著移除了，沒有用。
  2. 對照目前的程式碼跟網路下載的 wordpress 4.8 程式碼，也幾乎是一樣的。
  3. 試著直接連線到資料庫看，資料表格一切正常，權限也都是正確的。
  4. 直接在 wp-config.php 裡加入 
    define('WP_DEBUG', true);
define('WP_DEBUG_DISPLAY', false);
define('WP_DEBUG_LOG', true);

    ，然後看 wp-content/debug.log ，終於找到一點蛛絲馬跡。

看來是因為 wp-include/vars.php 有問題，裏面用 preg_match 檢查 _SERVER[‘PHP_SELF’] 時，因為 match 不到而出錯，猜想這可能連到影響到後續的 $typenow 有問題。根據這個線索去推敲，PHP 應該沒問題，察看了 php-fpm 的設定，也沒問題。後來找到這篇：php – Wrong SCRIPT_FILENAME in Apache 2.4.26 – Stack Overflow，再循線看到這篇：php – Wrong SCRIPT_FILENAME in Apache 2.4.26 – Stack Overflow才知道可能是 Apache 問題，察看了 pacman 的 log，果然前幾天有更新，但是因為沒有重新啟動，所以都沒發現問題。在設定裡補上

ProxyFCGIBackendType GENERIC

以後，重新啟動 Apache 就沒問題了。

Posted on

awk 一行下載

為了下載投影片，但懶得一個個複製貼上、改指令，所以預先把投影片網址跟預定的檔名放在文字檔裡，然後用 awk 一次下載。

文字檔的格式是：url filename ，假定這個文字檔的檔名是 slides.txt

那麼，這樣就能搞定：

awk '{system("wget -O \"" $2 "\" " $1)}' slides.txt

參考資料：bash – awk system call – Stack Overflow

Posted on

parse-server 架設小記

花了一些時間簡單的架設 parse-server，把過程紀錄一下。

  1. 安裝 docker 與 docker-compose
  2. git clone https://github.com/parse-community/parse-server.git
  3. 建立 docker image： 
    cd parse-server && docker build --tag parse-server .
  4. git clone https://github.com/parse-community/parse-dashboard.git
  5. 建立 docker image： 
    docker build --tag parse-dashboard .
  6. 建立 config.json，your-ip 要填你瀏覽器可以存取到的 IP ，而不是用 docker container 的 ip ，我本來是填 http://parse:1337/parse (請看 docker-compose.yml 裡的 links)，但這樣 parse-dashboard 會說無法連到伺服器。 
    {
  "apps": [
    {
      "serverURL": "http://<your-ip>:1337/parse",
      "appId": "APPLICATION_ID",
      "masterKey": "MASTER_KEY",
      "appName": "MyApp",
      "production": false
    }
  ],
  "users": [
    {
      "user": "user",
      "pass": "pass"
    }
  ]
}
  7. 建立 docker-compose.yml 
    ---
version: '3'
services:
  mongodb:
    image: mongo:3.4

  parse:
    image: parse-server:latest
    environment:
      FOO: bar
    command: --appId APPLICATION_ID --masterKey MASTER_KEY --databaseURI mongodb://mongodb/test
    links:
      - mongodb
    ports:
      - "1337:1337"
  parse-board:
    image: parse-dashboard:latest
    environment:
      PARSE_DASHBOARD_ALLOW_INSECURE_HTTP: "yes"
    links:
      - parse
    ports:
      - "4040:4040"
    volumes:
      - ./config.json:/src/Parse-Dashboard/parse-dashboard-config.json
  8. docker-compose up

要啟用 push notification ，得調整 docker-compose.yml 裡 parse service 的 command，加入 push notification 的相關選項。從選項可以看出，parse 仍是利用 GCM/APNs 來發送通知。

LiveQuery 在佈署到 AWS 時，要用 ALB，因為 ELB 不支援 WebSocket。

在正式環境裡，要記得把 PARSE_DASHBOARD_ALLOW_INSECURE_HTTP 設為 “no” ，並且加上 SSL 。也可以參考 parse-server github 網頁上對於佈署的說明，有蠻多佈署到平台上的現成範例可參考。

參考資料：

Posted on

webui-aria2-git

aria2 的 web UI，紀錄一下怎麼使用。

  1. 安裝：yaourt -S webui-aria2-git
  2. 啟動 aria2d：放在 /usr/lib/systemd/user/ 下的 service 檔案，需要額外加上 –user 參數，所以要啟動得用 systemctl –user start aria2d 。要確定是否有啟動，可以用 netstat 檢查 port 6800 是否在 listening 狀態。
  3. Web UI 部份的啟動：主要是靜態 HTML，所以只要調整 Web server 的設定，指向 /usr/share/webui-aria2/ 就可以了。

提高安全性：

  1. 修改 /usr/lib/systemd/user/aria2d.service ，在 ExecStart 那行後面加上 –rpc-secret=<your_token> ，–rpc-secret 是加上 token。
  2. 打開網頁時，在連線設定裡填入步驟 1 的 token 。

參考資料：

Posted on

ultisnips/vim-snippets

本來是打算用 snipmate 的，但看到這篇 UltiSnips 让 Vim 飞起来 – 吕小荣 ，馬上轉投 UltiSnips 。XD

安裝與設定上沒什麼困難。

" Install ultisnips using Vundle
Plugin 'SirVer/ultisnips'
Plugin 'honza/vim-snippets'

裝好以後，輸入特定的關鍵字 （關鍵字要自己去挖 vim-snippets 下的 UltiSnips/snippets 資料夾裡的檔案），再按 tab ，就會自動出現 snippet，如果 snippet 有指定 ${1:pass} 之類的，可以在輸入完畢以後，用 ctrl + j 或 ctrl + k 來切到上一個或下一個位置。

我卡到的問題是自訂的 snippets 沒被載入。找了半天，才發現我把 UltiSnips 資料夾放錯位置。(把我的時間還來!!)

UltiSnips 的 python docstring 可以自訂，看格式是要用 google, sphinx, doxygen, numpy 還是 jedi 的格式。在 .vimrc 裡放下面這行就可以了：

let g:ultisnips_python_style="google"
Posted on

Jenkins EnvInject

Jenkins 裡能用的環境變數可以參考：

  1. Jenkins 架設好以後的 /env-vars.html/
  2. https://wiki.jenkins-ci.org/display/JENKINS/Building+a+software+project#Buildingasoftwareproject-JenkinsSetEnvironmentVariables

但是有時候，就是覺得少了那麼一些。我們可以使用 EnvInject plugin 在建置時，插入需要的環境變數，讓後續的建置步驟使用。

使用方法：

  1. 在 EnvInject 之前的步驟產生出類似這樣格式的檔案 key=value ，假設檔名是 build.properties
  2. 加入 EnvInject，在 Properties File Path 這欄位放入步驟 1 產出的檔名 build.properties ；Properties Content 不填。
  3. 在 EnvInject 之後的步驟欄位裡，就可以使用 ${key} 了。

參考資料：

Posted on

docker daemon socket

dockerd 預設只使用 /var/run/docker.sock，如果需要讓其他的 host 去管理，就需要額外設定。

在 Ubuntu trusty 裡，要編輯 /etc/default/docker，加入

DOCKER_OPTS="-H 0.0.0.0:2375"

然後重新啟動就可以了。

不過這樣設定以後，就等於任何人都可以透過這個 port 去控制你這台機器裡的所有 container ，官方建議加上 TLS 來保障連線的安全，晚點再來研究怎麼加上 TLS 。

參考資料：