```
---
## 查 master / topology（最常用）
- 查所有被監控的 masters（摘要列表）
```redis
SENTINEL masters
1) 1) "name"
2) "mymaster"
3) "ip"
4) "10.10.10.202"
5) "port"
6) "6379"
7) "runid"
8) "3bf7dbeca2952f3b9bbe3961b2b75bc3c03bc040"
9) "flags"
10) "master"
11) "link-pending-commands"
12) "0"
13) "link-refcount"
14) "1"
15) "last-ping-sent"
16) "0"
17) "last-ok-ping-reply"
18) "533"
19) "last-ping-reply"
20) "533"
21) "down-after-milliseconds"
22) "30000"
23) "info-refresh"
24) "7634"
25) "role-reported"
26) "master"
27) "role-reported-time"
28) "44657033"
29) "config-epoch"
30) "9"
31) "num-slaves"
32) "2"
33) "num-other-sentinels"
34) "2"
35) "quorum"
36) "2"
37) "failover-timeout"
38) "180000"
39) "parallel-syncs"
40) "1"
```
- 查特定 master 的詳細資訊
```redis
SENTINEL master mymaster
```
- 取得 master 的位址（最常用，拿 IP/Port）
```redis
SENTINEL get-master-addr-by-name mymaster
```
- 查 master 的 replicas（從節點清單）
```redis
SENTINEL replicas mymaster
# 舊名（相容）
SENTINEL slaves mymaster
```
- 查同一個 master 的其他 sentinels
```redis
SENTINEL sentinels mymaster
```
---
## 健康/狀態判斷（排錯必備）
- 看 master 是否被標記 down、目前狀態旗標
```redis
SENTINEL master mymaster
# 觀察 "flags"、"last-ok-ping-reply"、"s-down-time" 等欄位
```
- Sentinel 自己資訊（版本、runid、監控數量）
```redis
INFO
```
- 看 Sentinel 的事件（需要開啟通知才會比較多）
```redis
SENTINEL ckquorum mymaster
```
> 這個會告訴你 quorum 是否足夠（例如你設定 quorum=2，是否能形成共識）。
---
## 故障轉移操作（小心用）
- 立即對指定 master 觸發 failover
```redis
SENTINEL failover mymaster
```
- 中止正在進行的 failover（如果卡住）
```redis
SENTINEL abortfailover mymaster
```
- 主動要求 Sentinel 重新掃描、更新配置（常用在手動改 IP/Port 後）
```redis
SENTINEL reset mymaster
# 或 reset 全部（小心）
SENTINEL reset *
```
---
## 動態改監控設定（線上調參）
- 修改 down-after-milliseconds（多久沒回就判定 down）
```redis
SENTINEL set mymaster down-after-milliseconds 30000
```
- 修改 failover-timeout（failover 超時）
```redis
SENTINEL set mymaster failover-timeout 180000
```
- 修改 parallel-syncs（一次同步幾台 replica）
```redis
SENTINEL set mymaster parallel-syncs 1
```
- 修改 quorum（通常不建議頻繁改）
```redis
SENTINEL set mymaster quorum 2
```
- 查看目前可用的 set 參數（不同版本可能略不同）
```redis
SENTINEL help
```
---
## 通知與腳本（你目前有 deny）
你現在設定：
```conf
sentinel deny-scripts-reconfig yes
```
所以 sentinel 腳本重配置會被限制。常見指令/配置（了解用）：
- 設定通知腳本（在 config 檔內）
```conf
sentinel notification-script mymaster /path/to/script
sentinel client-reconfig-script mymaster /path/to/script
```
---
## 常用排錯流程（超快）
1. Sentinel 能不能連：
```redis
PING
```
2. master 位址：
```redis
SENTINEL get-master-addr-by-name mymaster
```
3. master 狀態：
```redis
SENTINEL master mymaster
```
4. replicas 狀態：
```redis
SENTINEL replicas mymaster
```
5. quorum 是否健康：
```redis
SENTINEL ckquorum mymaster
```
---
## 小提醒（你很常遇到的）
- **Sentinel 不支援 `SELECT`**，因為它不是資料庫服務，是監控/仲裁服務。
- `SENTINEL get-master-addr-by-name` 回的 IP/HostName 對外能不能用，取決於你的網路（Docker 內外網、DNS、announce 等設定）。
# Docker
# 【上課筆記】【hiskio】Docker 完全實作！結合 3 大語言掌握容器實務應用
##### 上課講義
[Docker 完全實作 – Dropbox Paper](https://paper.dropbox.com/doc/Docker--BaNWxS3HDfry~X6QJb7Ze4plAg-pcGbQoyLtmiPPoIlkkK2r)
---
[](https://bookstack.treemanou.com/uploads/images/gallery/2022-01/0giARnkNtAdZy4q4-image-1642476831997.png)
nocopy : 存在檔案不覆蓋
# Docker 完全實作
#  讓我們先複習一下 Docker 的安裝
## Windows 上的 Docker 環境建置
[https://docs.docker.com/desktop/windows/install/](https://docs.docker.com/desktop/windows/install/)
- 什麼是WSL？
- 適用於 Linux 的 Windows 子系統可讓開發人員執行 GNU/Linux 環境 (包括大部分的命令列工具、公用程式和應用程式)，直接在 Windows 上執行，不需進行修改，不會造成傳統虛擬機器或 dualboot 設定的額外負荷。
- [https://docs.microsoft.com/zh-tw/windows/wsl/about](https://docs.microsoft.com/zh-tw/windows/wsl/about)
[https://www.youtube.com/watch?v=lIkxbE\_We1I&](https://www.youtube.com/watch?v=lIkxbE_We1I&)
[https://youtu.be/lIkxbE\_We1I](https://youtu.be/lIkxbE_We1I)
## Mac 上的 Docker 環境建置
[https://docs.docker.com/desktop/mac/install/](https://docs.docker.com/desktop/mac/install/)
- 如果您的筆電是Apple M1 (Silicon) CPU的話，請參考此處的安裝方式：
- [https://docs.docker.com/desktop/mac/apple-silicon/](https://docs.docker.com/desktop/mac/apple-silicon/)
 **Apple M1的限制**
- 非所有映像檔都可用於 ARM64 架構。可以使用 --platform linux/amd64 模擬運行。但 mysql 不適用於 ARM64，不過可以使用 mariadb 解決此問題。
- 模擬Intel的容器可能會有不穩定的狀況出現，除了速度比較慢之外，也會使用更多的記憶體。
- 無法從容器內部 ping 到 Internet。要測試網絡，我們建議使用 curl 或 wget 。
- 當 TCP half-close 時，數據可能偶爾會丟失。
-
## Linux 上的 Docker 環境建置
[https://docs.docker.com/engine/install/ubuntu/](https://docs.docker.com/engine/install/ubuntu/)
## 實務上需要注意的事
-  在大型組織（超過 250 名員工或超過 1000 萬美元的收入）中使用 Docker Desktop 需要付費訂閱 Docker。 雖然此條款的生效日期是 2021 年 8 月 31 日，但對於需要付費訂閱的用戶，寬限期到 2022 年 1 月 31 日。
**CPU/Memory資源**
**掛載目錄**
**Buildkit**
**回復初始設定**
#  工欲善其事，必先利其器：Docker 技術快覽
## Docker 常用指令
**執行容器**
`# 跑一個新的apache容器 `
`docker run httpd:alpine `
`# 跑一個背景執行的apache容器，並取名為apache `
`docker run -d --name apache httpd:alpine `
`# 跑一個redis容器，啟動虛擬終端機，進入互動模式，在容器中執行sh `
`docker run -it --rm redis:alpine sh `
- -it : i 指的就是互動模式，而 t 就是指terminal的意示
- --rm :指的是當容器結束後，將容器從系統移除
**列出容器**
`# 列出所有執行中容器
`docker ps `
`# 列出所有容器
`docker ps -a `
**停止容器**
`# 停止apache 容器 `
`docker stop `
**重新啟動容器**
`# 重新啟動apache `
`docker restart `
**Kill容器**
`#強制停止容器 `
`docker kill apache `
**移除容器**
`#移除apache `
`docker rm apache `
`#檢查所有容器 `
`docker ps -a `
`#移除所有容器 `
`docker rm -f $(docker ps -a -q) `
**複製檔案**
`# 建立一個hello.html `
`echo "hello" > hello.html `
`# 建立apache `
`docker run -d --name apache httpd:alpine `
`# 複製檔案至apache 容器中 `
`docker cp hello.html apache:/usr/local/apache2/htdocs/ `
`# 複製apache 容器中的檔案至本機 `
`docker cp apache:/usr/local/apache2/htdocs/index.html ./index.html `
**在容器內執行程式**
`#在容器中執行shell `
`docker exec -it apache sh `
**掛載目錄**
`#把hello.html掛成index.html `
`docker run -d --name apache2 -v $PWD/hello.html:/usr/local/apache2/htdocs/index.html httpd:alpine `
`# copy出來驗證內容是否一樣 `
`docker cp apache2:/usr/local/apache2/htdocs/index.html ./index.html `
`diff index.html hello.html `
**建立外部連線**
`#把「本機的80埠」對應到「容器中的80埠」 `
`docker run -d -v $PWD/hello.html:/usr/local/apache2/htdocs/index.html -p 80:80 httpd:alpine `
[http://127.0.0.1:80](http://127.0.0.1:80)
-  [如何從容器中，連到本機上的服務呢](https://stackoverflow.com/questions/24319662/from-inside-of-a-docker-container-how-do-i-connect-to-the-localhost-of-the-mach) ？
- 可以在容器中使用 host.docker.internal 來連接本機上的服務喔！
**查看容器狀態**
`# 查看 CPU、記憶體與網路用量
`docker stats `
**查看容器內的行程**
`# 查看容器內部的行程
`docker top apache `
`docker top apache2 `
**查看容器Logs**
`#查看log `
`docker logs apache `
`#持續查看 `
`docker logs -f apache2 `
**建立映像檔**
`# 於當前目錄，按Dockerfile.test中的指令，建立test:v1的映像檔 `
`docker build . -f Dockerfile.test -t test:v1 `
**拉取與推送映像檔**
`#從docker hub下載 node的image `
`docker pull node:alpine `
`#將下來的image，再給於新的標籤 `
`docker tag node:alpine macchiang/node:alpine `
`#推送新的標籤至私人倉庫 `
`docker push macchiang/node:alpine `
**清除映像檔與容器**
`#停掉全部container `
`docker stop $(docker ps -a -q) `
`#刪除所有沒有使用的container與image `
`docker system prune `
`#刪除所有映像檔 `
`docker rmi $(docker images -a -q) `
`#清除volume `
`docker volume rm $(docker volume ls) `
`#刪除所有沒有使用的container、image及所有volume `
`docker system prune -a -f --volumes `
## Dockerfile 起手式
**基本組成**
`# Base Image - Official Alpine
`FROM alpine `
` `
`LABEL "maintainer"="macchiang@gmail.com" `
` `
`# Upgrade existing packages in the base image
`RUN apk --no-cache upgrade `
` `
`# Install apache from packages with out caching install files
`RUN apk add --no-cache apache2 `
` `
`# Open port for httpd access
`EXPOSE 80 `
` `
`# Run httpd in foreground
`CMD ["-D","FOREGROUND"] `
` `
`# Start httpd when container runs
`ENTRYPOINT ["/usr/sbin/httpd"] `
-  **CMD** vs. **ENTRYPOINT**
- CMD配置的是預設命令，是可以被複寫掉的。而ENTRYPOINT是一定會執行的命令。
- 兩者共用的話，完整的命令會是 ENTRYPOINT + CMD
建立docker image
`docker build . -t apache:v1 `
複寫CMD
`#直接複寫CMD，改為顯示版號 `
`docker run --rm apache:v1 -v `
**ENV環境變數**
`FROM alpine `
`ENV NODE_ENV="development" `
**ARG傳入參數**
`FROM alpine `
`ARG NODE_ARG `
`ENV NODE_ENV="${NODE_ARG:-development}" `
`RUN echo "ARG=${NODE_ARG}, ENV=${NODE_ENV}" `
`CMD echo "ARG=${NODE_ARG}, ENV=${NODE_ENV}" `
`# 傳入NODE_ARG `
`docker build --build-arg NODE_ARG=staging . `
`# 傳入NODE_ARG `
`DOCKER_BUILDKIT=0 docker build . `
**COPY與ADD 複製文件**
- 功能：將檔案複製到image中
- 差異：
- COPY只能複製本機端的檔案或目錄
- ADD可增加url的檔案到docker image (建議改用RUN curl/wget)
- ADD可將本機端認可的壓縮格式tar解開後複製進去(要小心)
- 最佳實踐： 盡量使用 COPY 而不是 ADD
`#複製package.json到/app下 `
`COPY package.json /app/ `
`#複製所有file開頭的檔案到/app下，並改變檔案所屬用戶與群組 `
`COPY --chown=user :group file* /app/ `
-  若有些檔案不需要加入到image中， 可以建立 .dockerignore 來忽略喔！
**WORKDIR工作目錄**
`# hi.txt會在/目錄下 `
`RUN echo "say hi" > hi.txt `
`WORKDIR /app `
`# world.txt會在/app的目錄下 `
`RUN echo "hello" > world.txt `
**USER指定當前用戶**
`#新增group與user `
`RUN groupadd -r redis && useradd -r -g redis redis `
`#指定當前的user為redis `
`USER redis `
`#以redis的身份執行redis-server `
`RUN [ "redis-server" ] `
**HEALTHCHECK 健康檢查**
`FROM nginx `
`RUN apt-get update && apt-get install -y curl && `
`HEALTHCHECK --interval=5s --timeout=3s \ `
` CMD curl -fs http://localhost/ || exit 1 `
## 打造最小的Docker映像檔
**多階段建置Multi-stage Build**
`# Stage 1 建置環境 `
`FROM alpine build `
`RUN echo "hello" > mytest `
` `
`# Stage 2 執行環境 `
`FROM alpine `
` /mytest . `
`RUN cat /mytest `
**Distroless**
[https://github.com/GoogleContainerTools/distroless](https://github.com/GoogleContainerTools/distroless)
[https://github.com/GoogleContainerTools/distroless/tree/main/examples/go](https://github.com/GoogleContainerTools/distroless/tree/main/examples/go)
main.go
`package main `
` `
`import "fmt" `
` `
`func main() { `
` fmt.Println("Hello, world!") `
`} `
Dockerfile
`FROM golang:1.12 as build-env `
`WORKDIR /go/src/app `
`COPY . /go/src/app `
`RUN go get -d -v ./... `
`RUN go build -o /go/bin/app `
` `
`FROM gcr.io/distroless/base `
`COPY --from=build-env /go/bin/app / `
`CMD ["/app"] `
## 建立多重系統架構的映像檔
**不同執行環境的問題**
**使用Buildx建構多重系統架構的映像檔**
[https://docs.docker.com/desktop/multi-arch/](https://docs.docker.com/desktop/multi-arch/)
`#確認目前的builder為何 `
`docker buildx ls `
`#建立新的builder並切換過去 `
`docker buildx create --name multiarch --use `
 若在linux環境中建立builder的話，需要額外跑qemu-user-static容器，並將driver設為docker-container
`docker run --rm --privileged multiarch/qemu-user-static --reset -p yes `
`docker buildx create --name multiarch --driver docker-container --use `
`#檢查目前的builder `
`docker buildx inspect --bootstrap `
`#建立支援amd64與arm64的image，並且推送至registry `
`docker buildx build . --platform linux/amd64,linux/arm64 --push -t hello:v1 `
#  一次控制多個容器：Docker Compose
## Docker Compose 的概念
- 定義和運行多個容器應用。
- 使用 YAML 文件來配置應用服務
- 使用單一命令從配置中創建和啟動所有服務
- 適用於所有環境：生產、Staging、開發、測試以及 CI 工作流
## Docker Compose 文件格式
**基本格式**
預設文件名稱為 docker-compose.yml
`version: "3" `
`services: `
` webapp: `
` #指定image `
` image: httpd:alpine `
` ports: `
` - "80:80" `
` volumes: `
` - "/data" `
**build 建立映像檔**
`version: '3' `
`services: `
` webapp: `
` #從Dockerfile-alternate建立映像檔 `
` build: `
` context: . `
` dockerfile: Dockerfile-alternate `
` args: `
` buildno: 1 `
[https://docs.microsoft.com/zh-tw/visualstudio/docker/tutorials/use-docker-compose](https://docs.microsoft.com/zh-tw/visualstudio/docker/tutorials/use-docker-compose)
[https://docs.docker.com/compose/compose-file/compose-file-v3/](https://docs.docker.com/compose/compose-file/compose-file-v3/)
## Docker Compose 命令參考
[https://docs.docker.com/compose/reference/](https://docs.docker.com/compose/reference/)
**執行docker compose**
`#前景執行 `
`docker-compose up `
`#背景執行 `
`docker-compose up -d `
**停止/啟動docker compose**
`docker-compose stop `
**移除docker compose**
`docker-compose down `
`#也同步移除volume `
`docker-compose down -v `
**列出containers**
`docker-compose ps `
**監看logs**
`docker-compose logs `
`#follow logs `
`docker-compose logs -f `
**執行程式**
`docker-compose exec webapp sh `
**顯示執行程序**
`docker-compose top `
## Docker Compose 環境變數
**environment**
`environment: `
` RACK_ENV: development `
` SHOW: 'true' `
` SESSION_SECRET: `
`environment: `
` - RACK_ENV=development `
` - SHOW=true `
` - SESSION_SECRET `
**env\_file**
.env
`VAR=hello `
`MYENV=development `
`env_file: .env `
`env_file: `
` - ./common.env `
` - ./apps/web.env `
` - /opt/runtime_opts.env `
## Docker Compose 健康檢查
`healthcheck: `
` test: ["CMD", "curl", "-f", "http://localhost"] `
` interval: 1m30s `
` timeout: 10s `
` retries: 3 `
` start_period: 40s `
## Docker Compose 起動順序
`version: "3" `
`services: `
` web: `
` build: . `
` ports: `
` - "80:8000" `
` depends_on : `
` - "db" `
` command: ["./wait-for-it.sh", "db:5432", "--", "python", "app.py"] `
` db: `
` image: postgres `
**** **小工具**
- [wait-for-it](https://github.com/vishnubob/wait-for-it)
- [wait-for](https://github.com/Eficode/wait-for)
## Docker Compose 磁碟掛載
Long syntax
`version: "3.9" `
`services: `
` web: `
` image: nginx:alpine `
` volumes : `
` - type: volume `
` source: mydata `
` target: /data `
` volume: `
` nocopy : true `
` - type: bind `
` source: ./static `
` target: /opt/app/static `
` `
` db: `
` image: postgres:latest `
` volumes : `
` - "/var/run/postgres/postgres.sock:/var/run/postgres/postgres.sock" `
` - "dbdata:/var/lib/postgresql/data" `
` `
`volumes : `
` mydata: `
` dbdata: `
Short syntax
`volumes: `
` # Just specify a path and let the Engine create a volume `
` - /var/lib/mysql `
` `
` # Specify an absolute path mapping `
` - /opt/data:/var/lib/mysql `
` `
` # Path on the host, relative to the Compose file `
` - ./cache:/tmp/cache `
` `
` # User-relative path `
` - ~/configs:/etc/configs/:ro `
` `
` # Named volume `
` - datavolume:/var/lib/mysql `
#  如何導入Docker
## Docker導入流程
1. 確認應用程式使用的程式語言與版本
2. 參考相同程式語言的Dockerfile寫法
3. 列出應用程式相依的套件(包含系統、語言、字型等等)
4. 列出應用程式的設定(環境變數、設定檔)
5. 撰寫Dockerfile並測試
6. 檢查是否有檔案不該加入映像檔中( .dockerignore )
7. 列出應用程式相依的服務(Database、Redis)
8. 確認服務啟動順序並撰寫Docker Compose yaml
## 實作：Node.js + MongoDB打造API服務
[https://github.com/macchiang/node-express-mongo-example](https://github.com/macchiang/node-express-mongo-example)
**透過 Dockerfile 部署 Node.js 環境**
`# Base image `
`FROM node:16-alpine `
` `
`RUN apk upgrade --no-cache `
` `
`# Create app directory `
`RUN mkdir -p /app `
`WORKDIR /app `
` `
`# Install app dependencies `
`COPY package.json package-lock.json ./ `
`RUN npm install `
` `
`# copy app source `
`COPY . /app `
` `
`# service port `
`EXPOSE 3000 `
` `
`CMD [ "node", "index.js"] `
**Docker Compose YAML**
`version: "3.9" `
`services: `
` express: `
` build: `
` context: ./ `
` dockerfile: Dockerfile `
` image: express:latest `
` ports: `
` - 3000:3000 `
` depends_on: `
` - mongo `
` mongo: `
` image: mongo:5 `
` ports: `
` - 27017:27017 `
` `
`volumes: `
` mongo_data: `
##  作業-health check的妙用
- 請在Node.js + MongoDB的 Docker Compose YAML中加入health check，以確保當MongoDB啟動後，才啟動express
#  Docker X Python實作：快速打造 LINE Bot
## 透過 Dockerfile 建立 Python 環境
**確認python的image與版本**
[https://hub.docker.com/\_/python](https://hub.docker.com/_/python)
**了解Dockerfile**
` `
`WORKDIR /usr/src/app `
` `
`COPY requirements.txt ./ `
`RUN pip install --no-cache-dir -r requirements.txt `
` `
`COPY . . `
` `
`CMD [ "python", "./your-daemon-or-script.py" ] `
` `
## Flask + Redis 打造計數器
[https://github.com/macchiang/hit-counter](https://github.com/macchiang/hit-counter)
docker-compose.yml
`version: '2' `
`services: `
` myapp: `
` build: . `
` ports: `
` - "80:5000" `
` redis-lb: `
` image: "redis:alpine" `
## 構建 Django Web server
[https://github.com/macchiang/django-todolist](https://github.com/macchiang/django-todolist)
[https://developer.mozilla.org/zh-TW/docs/Learn/Server-side/Django/Introduction](https://developer.mozilla.org/zh-TW/docs/Learn/Server-side/Django/Introduction)
**先了解專案的安裝方式**
**Dockerfile**
` `
`WORKDIR /app `
` `
`COPY requirements.txt ./ `
`RUN pip install --no-cache-dir -r requirements.txt `
` `
`COPY todo/* . `
`RUN python manage.py migrate `
`CMD [ "python", "manage.py", "runserver" ] `
**docker-compose.yaml**
`version: '3.9' `
`services: `
` myweb: `
` build: . `
` ports: `
` - "8000:8000" `
## 部署 LINE Bot 應用
[https://github.com/macchiang/line-bot-tutorial](https://github.com/macchiang/line-bot-tutorial)
[https://github.com/line/line-bot-sdk-python/tree/master/examples/simple-server-echo](https://github.com/line/line-bot-sdk-python/tree/master/examples/simple-server-echo)
**在你開始之前**
確保您具有以下內容：
- 擁有 Line 帳號
- 擁有 [Heroku](https://www.heroku.com/) 帳戶（您可以免費創建一個）
**建立LINE Bot 頻道**
- [Messaging API 介紹](https://developers.line.biz/zh-hant/docs/messaging-api/overview/)
- [開始使用 Messaging API](https://developers.line.biz/zh-hant/docs/messaging-api/getting-started/)
- 取得 **Channel access token** 與 **Channel secret**
- 關閉預設罐頭回覆訊息
**建立Docker Image**
`FROM python:3-slim-bullseye `
`WORKDIR /app `
`COPY requirements.txt ./ `
`RUN pip install --no-cache-dir -r requirements.txt `
`COPY app.py . `
`CMD [ "python", "app.py"] `
`docker build . -t line-bot:latest `
**安裝Heroku CLI**
[https://devcenter.heroku.com/articles/heroku-cli#download-and-install](https://devcenter.heroku.com/articles/heroku-cli#download-and-install)
**建立Heroku App**
`#登入heroku `
`heroku login `
`#登入heroku registry `
`heroku container:login `
`#建立app `
`heroku create `
` `
`#Creating app... done, ⬢ morning-journey-43865 `
`# https://morning-journey-43865.herokuapp.com/ | https://git.heroku.com/morning-journey-43865.git `
` `
`#推送docker image至heroku registry `
`docker tag line-bot:latest registry.heroku.com/ morning-journey-43865 /web `
`docker push registry.heroku.com/ morning-journey-43865 /web `
` `
` `
`#設定環境變數 `
`heroku config:set CHANNEL_ACCESS_TOKEN=xxxxxxxxx `
`heroku config:set CHANNEL_SECRET=xxxxxxxxx `
` `
`#deploy docker image `
`heroku container:release web `
**設定Webhook**
[https://devcenter.heroku.com/articles/container-registry-and-runtime](https://devcenter.heroku.com/articles/container-registry-and-runtime)
**加入好友與測試**
**Debug**
`❯ heroku logs --tail
`2021-11-09T15:17:06.932541+00:00 app[api]: Release v1 created by user macchiang@gmail.com `
`2021-11-09T15:17:06.932541+00:00 app[api]: Initial release by user macchiang@gmail.com `
`2021-11-09T15:17:07.532399+00:00 app[api]: Release v2 created by user macchiang@gmail.com `
`2021-11-09T15:17:07.532399+00:00 app[api]: Enable Logplex by user macchiang@gmail.com `
`2021-11-09T15:22:12.485507+00:00 app[api]: Deployed web (1be43e5135d6) by user macchiang@gmail.com `
`2021-11-09T15:22:12.485507+00:00 app[api]: Release v3 created by user macchiang@gmail.com `
`2021-11-09T15:22:12.503987+00:00 app[api]: Scaled to web@1:Free by user macchiang@gmail.com `
`2021-11-09T15:22:15.916499+00:00 heroku[web.1]: Starting process with command `python app.py` `
`2021-11-09T15:22:18.365293+00:00 app[web.1]: Traceback (most recent call last): `
`2021-11-09T15:22:18.365308+00:00 app[web.1]: File "/app/app.py", line 15, in `
`2021-11-09T15:22:18.365410+00:00 app[web.1]: line_bot_api = LineBotApi(os.getenv('CHANNEL_ACCESS_TOKEN')) `
`2021-11-09T15:22:18.365411+00:00 app[web.1]: File "/usr/local/lib/python3.10/site-packages/linebot/api.py", line 63, in __init__ `
`2021-11-09T15:22:18.365516+00:00 app[web.1]: 'Authorization': 'Bearer ' + channel_access_token, `
`2021-11-09T15:22:18.374292+00:00 app[web.1]: TypeError: can only concatenate str (not "NoneType") to str `
`2021-11-09T15:22:18.660220+00:00 heroku[web.1]: Process exited with status 1 `
`2021-11-09T15:22:19.074969+00:00 heroku[web.1]: State changed from starting to crashed `
`2021-11-09T15:22:19.218365+00:00 heroku[web.1]: State changed from crashed to starting `
`2021-11-09T15:22:22.107500+00:00 heroku[web.1]: Starting process with command `python app.py` `
`2021-11-09T15:22:23.219784+00:00 app[web.1]: Traceback (most recent call last): `
`2021-11-09T15:22:23.219806+00:00 app[web.1]: File "/app/app.py", line 15, in `
`2021-11-09T15:22:23.219930+00:00 app[web.1]: line_bot_api = LineBotApi(os.getenv('CHANNEL_ACCESS_TOKEN')) `
`2021-11-09T15:22:23.219934+00:00 app[web.1]: File "/usr/local/lib/python3.10/site-packages/linebot/api.py", line 63, in __init__ `
`2021-11-09T15:22:23.219959+00:00 app[web.1]: 'Authorization': 'Bearer ' + channel_access_token, `
`2021-11-09T15:22:23.219961+00:00 app[web.1]: TypeError: can only concatenate str (not "NoneType") to str `
`2021-11-09T15:22:23.417290+00:00 heroku[web.1]: Process exited with status 1 `
`2021-11-09T15:22:23.492672+00:00 heroku[web.1]: State changed from starting to crashed `
`2021-11-09T15:22:38.443725+00:00 heroku[router]: at=error code=H10 desc="App crashed" method=GET path="/" host=morning-journey-43865.herokuapp.com request_id=b91dba06-950e-4887-840e-60fc5986866f fwd="36.227.157.168" dyno= connect= service= status=503 bytes= protocol=https `
`2021-11-09T15:22:39.424038+00:00 heroku[router]: at=error code=H10 desc="App crashed" method=GET path="/favicon.ico" host=morning-journey-43865.herokuapp.com request_id=becc5a52-35a7-4557-b751-02d382a2b67e fwd="36.227.157.168" dyno= connect= service= status=503 bytes= protocol=https `
#  Docker X PHP實作：架設一個 WordPress 網站
## 透過 Dockerfile 部署 PHP 環境
**先從** [**Php官方**](https://hub.docker.com/_/php) **Dockerfile學起**
[https://github.com/macchiang/php-hello-world](https://github.com/macchiang/php-hello-world)
Dockerfile
`FROM php:7.3-apache `
`COPY index.php /var/www/html/ `
建立Docker image與Container
`docker build . -t hello:latest `
`docker run -it --rm -p 8080:80 hello:latest `
[https://www.astralweb.com.tw/what-is-differences-between-fastcgi-php-fpm/](https://www.astralweb.com.tw/what-is-differences-between-fastcgi-php-fpm/)
## 將 MySQL 加入部署行列
[https://github.com/macchiang/php-docker-simple](https://github.com/macchiang/php-docker-simple)
docker-compose.yml
`# Use root/example user/password credentials `
`version: '3.1' `
` `
`services: `
` php: `
` build: `
` context: . `
` dockerfile: Dockerfile `
` ports: `
` - 80:80 `
` volumes: `
` - ./src:/var/www/html/ `
` `
` db: `
` image: mysql `
` command: --default-authentication-plugin=mysql_native_password `
` restart: always `
` environment: `
` MYSQL_ROOT_PASSWORD: example `
` volumes: `
` - mysql-data:/var/lib/mysql `
` `
` adminer: `
` image: adminer `
` restart: always `
` ports: `
` - 8080:8080 `
` `
`volumes: `
` mysql-data: `
## 建立WordPress 網站
**再由** [**WordPresss官方Dockerfile學起**](https://github.com/docker-library/wordpress/blob/master/latest/php7.3/apache/Dockerfile)
` # `
`# NOTE: THIS DOCKERFILE IS GENERATED VIA "apply-templates.sh" `
`# `
`# PLEASE DO NOT EDIT IT DIRECTLY. `
`# `
` `
`FROM php:7.3-apache `
` `
`# persistent dependencies `
`RUN set -eux; \ `
` apt-get update; \ `
` apt-get install -y --no-install-recommends \ `
`# Ghostscript is required for rendering PDF previews `
` ghostscript \ `
` ; \ `
` rm -rf /var/lib/apt/lists/* `
` `
`# install the PHP extensions we need (https://make.wordpress.org/hosting/handbook/handbook/server-environment/#php-extensions) `
`RUN set -ex; \ `
` \ `
` savedAptMark="$(apt-mark showmanual)"; \ `
` \ `
` apt-get update; \ `
` apt-get install -y --no-install-recommends \ `
` libfreetype6-dev \ `
` libjpeg-dev \ `
` libmagickwand-dev \ `
` libpng-dev \ `
` libwebp-dev \ `
` libzip-dev \ `
` ; \ `
` \ `
` docker-php-ext-configure gd \ `
` --with-freetype-dir=/usr \ `
` --with-jpeg-dir=/usr \ `
` --with-png-dir=/usr \ `
` --with-webp-dir=/usr \ `
` ; \ `
` docker-php-ext-install -j "$(nproc)" \ `
` bcmath \ `
` exif \ `
` gd \ `
` mysqli \ `
` zip \ `
` ; \ `
`# https://pecl.php.net/package/imagick `
` pecl install imagick-3.5.0; \ `
` docker-php-ext-enable imagick; \ `
` rm -r /tmp/pear; \ `
` \ `
`# reset apt-mark's "manual" list so that "purge --auto-remove" will remove all build dependencies `
` apt-mark auto '.*' > /dev/null; \ `
` apt-mark manual $savedAptMark; \ `
` ldd "$(php -r 'echo ini_get("extension_dir");')"/*.so \ `
` | awk '/=>/ { print $3 }' \ `
` | sort -u \ `
` | xargs -r dpkg-query -S \ `
` | cut -d: -f1 \ `
` | sort -u \ `
` | xargs -rt apt-mark manual; \ `
` \ `
` apt-get purge -y --auto-remove -o APT::AutoRemove::RecommendsImportant=false; \ `
` rm -rf /var/lib/apt/lists/* `
` `
`# set recommended PHP.ini settings `
`# see https://secure.php.net/manual/en/opcache.installation.php `
`RUN set -eux; \ `
` docker-php-ext-enable opcache; \ `
` { \ `
` echo 'opcache.memory_consumption=128'; \ `
` echo 'opcache.interned_strings_buffer=8'; \ `
` echo 'opcache.max_accelerated_files=4000'; \ `
` echo 'opcache.revalidate_freq=2'; \ `
` echo 'opcache.fast_shutdown=1'; \ `
` } > /usr/local/etc/php/conf.d/opcache-recommended.ini `
`# https://wordpress.org/support/article/editing-wp-config-php/#configure-error-logging `
`RUN { \ `
`# https://www.php.net/manual/en/errorfunc.constants.php `
`# https://github.com/docker-library/wordpress/issues/420#issuecomment-517839670 `
` echo 'error_reporting = E_ERROR | E_WARNING | E_PARSE | E_CORE_ERROR | E_CORE_WARNING | E_COMPILE_ERROR | E_COMPILE_WARNING | E_RECOVERABLE_ERROR'; \ `
` echo 'display_errors = Off'; \ `
` echo 'display_startup_errors = Off'; \ `
` echo 'log_errors = On'; \ `
` echo 'error_log = /dev/stderr'; \ `
` echo 'log_errors_max_len = 1024'; \ `
` echo 'ignore_repeated_errors = On'; \ `
` echo 'ignore_repeated_source = Off'; \ `
` echo 'html_errors = Off'; \ `
` } > /usr/local/etc/php/conf.d/error-logging.ini `
` `
`RUN set -eux; \ `
` a2enmod rewrite expires; \ `
` \ `
`# https://httpd.apache.org/docs/2.4/mod/mod_remoteip.html `
` a2enmod remoteip; \ `
` { \ `
` echo 'RemoteIPHeader X-Forwarded-For'; \ `
`# these IP ranges are reserved for "private" use and should thus *usually* be safe inside Docker `
` echo 'RemoteIPTrustedProxy 10.0.0.0/8'; \ `
` echo 'RemoteIPTrustedProxy 172.16.0.0/12'; \ `
` echo 'RemoteIPTrustedProxy 192.168.0.0/16'; \ `
` echo 'RemoteIPTrustedProxy 169.254.0.0/16'; \ `
` echo 'RemoteIPTrustedProxy 127.0.0.0/8'; \ `
` } > /etc/apache2/conf-available/remoteip.conf; \ `
` a2enconf remoteip; \ `
`# https://github.com/docker-library/wordpress/issues/383#issuecomment-507886512 `
`# (replace all instances of "%h" with "%a" in LogFormat) `
` find /etc/apache2 -type f -name '*.conf' -exec sed -ri 's/([[:space:]]*LogFormat[[:space:]]+"[^"]*)%h([^"]*")/\1%a\2/g' '{}' + `
` `
`RUN set -eux; \ `
` version='5.8.2'; \ `
` sha1='c3b1b59553eafbf301c83b14c5eeae4cf1c86044'; \ `
` \ `
` curl -o wordpress.tar.gz -fL "https://wordpress.org/wordpress-$version.tar.gz"; \ `
` echo "$sha1 *wordpress.tar.gz" | sha1sum -c -; \ `
` \ `
`# upstream tarballs include ./wordpress/ so this gives us /usr/src/wordpress `
` tar -xzf wordpress.tar.gz -C /usr/src/; \ `
` rm wordpress.tar.gz; \ `
` \ `
`# https://wordpress.org/support/article/htaccess/ `
` [ ! -e /usr/src/wordpress/.htaccess ]; \ `
` { \ `
` echo '# BEGIN WordPress'; \ `
` echo ''; \ `
` echo 'RewriteEngine On'; \ `
` echo 'RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]'; \ `
` echo 'RewriteBase /'; \ `
` echo 'RewriteRule ^index\.php$ - [L]'; \ `
` echo 'RewriteCond %{REQUEST_FILENAME} !-f'; \ `
` echo 'RewriteCond %{REQUEST_FILENAME} !-d'; \ `
` echo 'RewriteRule . /index.php [L]'; \ `
` echo ''; \ `
` echo '# END WordPress'; \ `
` } > /usr/src/wordpress/.htaccess; \ `
` \ `
` chown -R www-data:www-data /usr/src/wordpress; \ `
`# pre-create wp-content (and single-level children) for folks who want to bind-mount themes, etc so permissions are pre-created properly instead of root:root `
`# wp-content/cache: https://github.com/docker-library/wordpress/issues/534#issuecomment-705733507 `
` mkdir wp-content; \ `
` for dir in /usr/src/wordpress/wp-content/*/ cache; do \ `
` dir="$(basename "${dir%/}")"; \ `
` mkdir "wp-content/$dir"; \ `
` done; \ `
` chown -R www-data:www-data wp-content; \ `
` chmod -R 777 wp-content `
` `
`VOLUME /var/www/html `
` `
`COPY --chown=www-data:www-data wp-config-docker.php /usr/src/wordpress/ `
`COPY docker-entrypoint.sh /usr/local/bin/ `
` `
`ENTRYPOINT ["docker-entrypoint.sh"] `
`CMD ["apache2-foreground"] `
[https://github.com/macchiang/wordpress-demo](https://github.com/macchiang/wordpress-demo)
docker-compose.yaml
`version: "3.3" `
`services: `
` db: `
` image: mysql `
` volumes: `
` - db_data:/var/lib/mysql `
` restart: always `
` environment: `
` MYSQL_ROOT_PASSWORD: somewordpress `
` MYSQL_DATABASE: wordpress `
` MYSQL_USER: wordpress `
` MYSQL_PASSWORD: wordpress `
` wordpress: `
` depends_on: `
` - db `
` image: wordpress `
` ports: `
` - "8000:80" `
` restart: always `
` environment: `
` WORDPRESS_DB_HOST: db:3306 `
` WORDPRESS_DB_USER: wordpress `
` WORDPRESS_DB_PASSWORD: wordpress `
`volumes: `
` db_data: `
` `
#  Docker X Node.js實作：打造前後端具備的 To-Do List
## 建立Express + Nginx組合
[https://github.com/macchiang/express-nginx](https://github.com/macchiang/express-nginx)
**Nginx config**
`server { `
` listen 80 default_server; `
` listen [::]:80 default_server; `
` server_tokens off; `
` client_max_body_size 15M; `
` if ($http_x_forwarded_proto = "http") { `
` return 301 https://$host$request_uri; `
` } `
` location / { `
` proxy_set_header X-Real-IP $remote_addr; `
` proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; `
` proxy_set_header Host $http_host; `
` proxy_set_header X-NginX-Proxy true; `
` proxy_pass http://node:3000;
` proxy_redirect off; `
` } `
`} `
docker-compose.yml
`version: "3" `
`services: `
` nginx: `
` image: nginx:alpine `
` volumes: `
` - ./nginx:/etc/nginx/conf.d `
` links: `
` - node `
` ports: `
` - 80:80 `
` node: `
` build: `
` context: . `
` image: express-nginx:latest `
` `
## 打造To-Do List
[https://github.com/macchiang/express-mongoDB-TodoList](https://github.com/macchiang/express-mongoDB-TodoList)
Ddockerfile
`# Base image `
`FROM node:16-alpine `
`RUN apk upgrade --no-cache `
`# Create app directory `
`RUN mkdir -p /app `
`WORKDIR /app `
`# Install app dependencies `
`COPY package.json package-lock.json ./ `
`RUN npm install `
`# copy app source `
`COPY . /app `
`# service port `
`EXPOSE 3000 `
`CMD [ "node", "app.js"] `
docker-compose.yml
`version: "3" `
`services: `
` nginx: `
` image: nginx:alpine `
` volumes: `
` - ./nginx:/etc/nginx/conf.d `
` links: `
` - node `
` ports: `
` - 80:80 `
` node: `
` build: `
` context: . `
` depends_on: `
` - mongo `
` mongo: `
` image: mongo:5 `
` ports: `
` - 27017:27017 `
` volumes: `
` - mongo_data:/data/db `
`volumes: `
` mongo_data: `
#  參考資料
- [https://blog.gtwang.org/linux/docker-commands-and-container-management-tutorial/](https://blog.gtwang.org/linux/docker-commands-and-container-management-tutorial/)
- [https://hub.docker.com/r/broadtech/alpine-apache2/dockerfile](https://hub.docker.com/r/broadtech/alpine-apache2/dockerfile)
- [https://ithelp.ithome.com.tw/articles/10251549](https://ithelp.ithome.com.tw/articles/10251549)
- [https://www.tpisoftware.com/tpu/articleDetails/1216](https://www.tpisoftware.com/tpu/articleDetails/1216)
- [https://yeasy.gitbook.io/docker\_practice](https://yeasy.gitbook.io/docker_practice)
- [https://blog.techbridge.cc/2018/09/07/docker-compose-tutorial-intro/](https://blog.techbridge.cc/2018/09/07/docker-compose-tutorial-intro/)
- [https://yeasy.gitbook.io/docker\_practice/compose/usage](https://yeasy.gitbook.io/docker_practice/compose/usage)
- [https://dev.to/truthseekers/setup-a-basic-local-php-development-environment-in-docker-kod](https://dev.to/truthseekers/setup-a-basic-local-php-development-environment-in-docker-kod)
- [https://dotblogs.com.tw/explooosion/2018/09/15/194754#2](https://dotblogs.com.tw/explooosion/2018/09/15/194754#2)
- [https://dca.gitbooks.io/nodejs-tw-wiki-book/content/book/todo\_list/todo\_list.html](https://dca.gitbooks.io/nodejs-tw-wiki-book/content/book/todo_list/todo_list.html)
# 推薦學習
[https://dev.to/ankit01oss/7-github-projects-to-supercharge-your-docker-practices-2i80](https://dev.to/ankit01oss/7-github-projects-to-supercharge-your-docker-practices-2i80)
# 【上課筆記】【udemy】 Docker容器技术从入门到精通
### 上課講義
- [ https://www.docker.tips](https://www.docker.tips " https://www.docker.tips")
---
### 原始碼
- [Oh My Docker · GitHub](https://github.com/oh-my-docker)
- [GitHub - dockersamples/example-voting-app: Example Docker Compose app](https://github.com/dockersamples/example-voting-app)
# 【Demo】Python Flask + Redis 練習
### 準備一個python文件 app.py
```Python
from flask import Flask
from redis import Redis
import os
import socket
app = Flask(__name__)
redis = Redis(host=os.environ.get('REDIS_HOST', '127.0.0.1'), port=6379)
@app.route('/')
def hello():
redis.incr('hits')
return f"Hello Container World! I have been seen {redis.get('hits').decode('utf-8')} times and my hostname is {socket.gethostname()}.\n"
```
### 準備一個Dockerfile
```INI
FROM python:3.9.5-slim
RUN pip install flask redis && \
groupadd -r flask && useradd -r -g flask flask && \
mkdir /src && \
chown -R flask:flask /src
USER flask
COPY app.py /src/app.py
WORKDIR /src
ENV FLASK_APP=app.py REDIS_HOST=redis
EXPOSE 5000
CMD ["flask", "run", "-h", "0.0.0.0"]
```
### 準備一個Redis image
###
```shell
$ docker image pull redis
$ docker image build -t flask-demo .
$ docker image ls
REPOSITORY TAG IMAGE ID CREATED SIZE
flask-demo latest 4778411a24c5 About a minute ago 126MB
python 3.9.5-slim c71955050276 8 days ago 115MB
redis latest 08502081bff6 2 weeks ago 105MB
```
### 建立一Bridage
```shell
$ docker network create -d bridge demo-network
8005f4348c44ffe3cdcbbda165beea2b0cb520179d3745b24e8f9e05a3e6456d
$ docker network ls
NETWORK ID NAME DRIVER SCOPE
2a464c0b8ec7 bridge bridge local
8005f4348c44 demo-network bridge local
80b63f711a37 host host local
fae746a75be1 none null local
```
### 創建container
創建一個叫 `redis-server ` 的container，連到 demo-network上
```shell
$ docker container run -d --name redis-server --network demo-network redis
002800c265020310231d689e6fd35bc084a0fa015e8b0a3174aa2c5e29824c0e
$ docker container ls
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
002800c26502 redis "docker-entrypoint.s…" 4 seconds ago Up 3 seconds 6379/tcp redis-server
```
創建 flask container，連到 demo-network上
```shell
$ docker container run -d --network demo-network \
--name flask-demo \
--env REDIS_HOST=redis-server \
-p 5000:5000 flask-demo
```
打開瀏覽器訪問 [http://127.0.0.1:5000](http://127.0.0.1:5000/)
應該能看到類似下面的內容，每次刷新頁面，計數加1
Hello Container World! I have been seen 36 times and my hostname is 925ecb8d111a.
合併步驟成一腳本
```shell
# prepare image
docker image pull redis
docker image build -t flask-demo .
# create network
docker network create -d bridge demo-network
# create container
docker container run -d --name redis-server --network demo-network redis
docker container run -d --network demo-network --name flask-demo --env REDIS_HOST=redis-server -p 5000:5000 flask-demo
```
# 【Docker】【錯誤處理】無法停止服務
\*使用systemctl stop docker 無法停止服務
```shell
[root@localhost docker]# systemctl stop docker
Warning: Stopping docker.service, but it can still be activated by:
docker.socket
```
\*解決
```shell
#停止
[root@localhost docker]# systemctl stop docker.socket
[root@localhost docker]# systemctl stop docker.service
#啟動
[root@localhost docker]# systemctl daemon-reload
[root@localhost docker]# systemctl restart docker
```
\*\*如果還沒辦法解決
```shell
# 删除 docker socket 文件
cd /lib/systemd/system/ && rm -rf docker.socket
# 查看 docker 状态，已dead
sudo systemctl status docker.service
# 重新创建 docker.socket
cd /lib/systemd/system/
vim docker.socket
# 添加如下内容
[Unit]
Description=Docker Socket for the API
PartOf=docker.service
[Socket]
ListenStream=/var/run/docker.sock
SocketMode=0660
SocketUser=root
SocketGroup=docker
[Install]
WantedBy=sockets.target
```
```shell
#啟動
[root@localhost docker]# systemctl daemon-reload
[root@localhost docker]# systemctl restart docker
```
# 【Webmin】相關
查詢被Deny 需要從Zone default -> Allow queries form ... -> 【 Listed..】-> 加入 any -> 右上角 【 Apply 】
[](https://bookstack.treemanou.com/uploads/images/gallery/2023-04/ekv5h0IjPh5QuFza-image-1681888539338.png)
[](https://bookstack.treemanou.com/uploads/images/gallery/2023-04/3i1aqB3ElPohVONm-image-1681888508758.png)
[](https://bookstack.treemanou.com/uploads/images/gallery/2023-04/wxlJrQurZrfPxJgj-image-1681888698503.png)
# Docker 各系統安裝
### 各系統安裝連結
- zabbix
[https://www.zabbix.com/documentation/4.4/zh/manual/installation/containers](https://www.zabbix.com/documentation/4.4/zh/manual/installation/containers)
[https://github.com/zabbix/zabbix-docker/tree/6.4/Dockerfiles/web-nginx-pgsql](https://github.com/zabbix/zabbix-docker/tree/6.4/Dockerfiles/web-nginx-pgsql)
- elk
[https://github.com/deviantony/docker-elk](https://github.com/deviantony/docker-elk)
https://github.com/deviantony/docker-elk
[https://github.com/deviantony/docker-elk](https://github.com/deviantony/docker-elk)
注意，千萬不要誤以為使用 -v 就是用 Volume 的方式或者是 --mount 就是使用 Bind Mount 的方式，不是這樣的！！我們先來看看這兩個在 docker create 與 docker run 中的說明是甚麼：
```p2
-v, --volume list Bind mount a volume
--mount mount Attach a filesystem mount to the container
```
但其實是可以用 --mount 或 -v 來綁定資料到 Volume，也可以用 --mount 或 -v 來綁定資料到 Filesystem。既然都可以，那為什麼要分兩種呢？
這是因為 --mount 其實出現的比較早，但他設定綁定資料的方式比較完整卻麻煩，因此在後續又出現了 -v 的選項來簡化綁定的設定過程。
---
### **Data Volume**
相關指令
```shell
# 建立volume
# docker volume create [OPTIONS] [VOLUME]
$docker volume create my-vol
#使用 -v
$ docker run -d --name my-http -v my-vol:/usr/local/apache2 -p 8080:80 httpd
#使用 --mount
$ docker run -d --name my-http --mount source=my-vol,target=/usr/local/apache2 -p 8080:80 httpd
```
```shell
# 列出所有volume
[tomcat@docker]$ docker volume ls
DRIVER VOLUME NAME
local 2db2d2b1a6ceb9f578d2149dc44625e1996dcc33de0639f8644ce2082182b9a8
local my-vol
# 查詢某volume細節
[tomcat@docke]$ docker volume inspect 2db2d2b1a6ceb9f578d2149dc44625e1996dcc33de0639f8644ce2082182b9a8
[
{
"CreatedAt": "2019-06-04T15:40:43+08:00",
"Driver": "local",
"Labels": null,
"Mountpoint": "/var/lib/docker/volumes/2db2d2b1a6ceb9f578d2149dc44625e1996dcc33de0639f8644ce2082182b9a8/_data",
"Name": "2db2d2b1a6ceb9f578d2149dc44625e1996dcc33de0639f8644ce2082182b9a8",
"Options": null,
"Scope": "local"
}
]
[tomcat@docke]$ docker volume inspect my-vol
[
{
"CreatedAt": "2023-02-07T02:11:18Z",
"Driver": "local",
"Labels": {},
"Mountpoint": "/var/lib/docker/volumes/my-vol/_data",
"Name": "my-vol",
"Options": {},
"Scope": "local"
}
]
# 刪除所有不使用的volume
[tomcat@docker]$ docker volume prune
WARNING! This will remove all local volumes not used by at least one container.
Are you sure you want to continue? [y/N] y
Deleted Volumes:
2db2d2b1a6ceb9f578d2149dc44625e1996dcc33de0639f8644ce2082182b9a8
44d6286d1a793ac8c788b0fd364fa8d9430ce3ec079731dbe894dd996cae9adb
925559f4c2399c0c989d8602ca77fb3243dfb83022fe029b09b130c9521e7f89
9484acbd73c53af47f29add893c5125b0cd7f0f96e521c54e643f1aeb8f97eeb
b47202da45060de8f67e48058966b32078d525cadd1c94671a0ffe33f3d5df4b
006d620ae77bf7530ea37abd48b9c20ac264956f4b9ef3397e2c5072f32677c2
15e0fd2e575c2c24a2a137ff420dbf30326f3859d483561efc45e568d294c802
98b5385b04a401e9e870c5a1e807d69c56a1764b2ec91baedd9c13994cb2c863
ffdae0e84d00966afdc0df55d664d06ee99c14d249ad7558848088c464d472ff
Total reclaimed space: 77.8MB
# 指定volume mount 至 /var/www/html
[tomcat@docker]$ docker run -d -v html_doc:/var/www/html httpd
```
---
### **Bind Mount to FileSystem**
```shell
# 直接mount 外部資料夾 至 /var/www/html
# 相對路徑
[tomcat@docker-qc html-doc]$ docker run -d -v ${PWD}/html-doc:/var/www/html httpd
# 絕對路徑
[tomcat@docker-qc html-doc]$ docker run -d -v /home/tomcat/docker/html-doc:/var/www/html httpd
```
### **Bind Mount to Memory**
Tmpfs，全名 Temporary File System，是在 Linux 暫存檔儲存空間的常見名稱，通常以掛載檔案系統方式實現。他可以將資料儲存在記憶體中而不是存在硬碟內，所以只要一重新開機，資料則會被抹除。
Tmpfs 如其名，如果使用 Tmpfs Mount 則資料會存在於記憶體上，在重啟 Container 的時候就會 Reset 資料。
特別注意的是，使用 Tmpfs Mount 並不是使用 -v 的選項，而是使用 --tmpfs ， --tmpfs 就如同 -v一樣簡化了使用 --mount 時所需的設定。 registry ` (online) 從registry拉取
- public（公有）
- private（私有）
- build from `Dockerfile ` (online) 從Dockerfile構建
- load from `file ` (offline) 文件導入 （離線）
官方image:
[https://hub.docker.com/search?type=image&image\_filter=official](https://hub.docker.com/search?type=image&image_filter=official)
---
常用 public image server
- [Docker Hub Container Image Library | App Containerization](https://hub.docker.com/)
- [Quay Container Registry · Quay](https://quay.io/)
##### \*建立映像檔
```shell
# 於當前目錄，按Dockerfile.test中的指令，建立test:v1 ({name:tag})的映像檔
docker build . -f Dockrfile.test -t test:v1
```
##### \*拉取與推送映像檔
```shell
# 使用docker hub 下載image ({name:tag})
docker pull node:alpine
# 使用quay.io 下載image
docker pull quay.io/bitnami/tomcat
# node:alpine 重新命名標籤 username/nodea:alpine
docker tag node:alpine username/nodea:alpine
# 推送至私人倉庫
docker push username/node:alpine
```
---
##### 使用私有registry
```shell
# 修改鏡像registry
sudo vim /etc/docker/daemon.json
#########################################################
# 可與許http鏡像 "insecure-registries" : ["10.60.78.79"],
# 鏡像站 "registry-mirrors": ["http://hub-mirror.c.163.com"]
{
"registry-mirrors": ["https://docker.mirrors.ustc.edu.cn"]
}
#########################################################
# 使文件生效
sudo systemctl daemon-reload
# 重啟docker
sudo service docker restart
```
##### 使用proxy 抓取鏡像檔
\*ubuntu
```shell
# 編輯設定檔
vim /etc/default/docker
##檔案內容
export http_proxy="http://192.168.33.10:3128/"
export https_proxy="http://192.168.33.10:3128/"
##
# proxy 如果有帳密驗證
export http_proxy="https://username:password@192.168.33.10:3128/"
# 重啟docker
systemctl restart docker
```
\*centos
```shell
vim /etc/systemd/system/docker.service.d/http-proxy.conf
###################################################################################
[Service]
Environment="HTTP_PROXY=http://192.168.1.1:3128/"
Environment="HTTPS_PROXY=http://192.168.1.1:3128/"
#如果要排除不走
Environment="NO_PROXY=localhost,127.0.0.0/8,docker-registry.somecorporation.com"
###################################################################################
#重讀設定
systemctl daemon-reload
#重啟docker
systemctl restart docker
```
---
##### 查看image
```shell
# 取得id
[root@localhost ~]# docker image ls
REPOSITORY TAG IMAGE ID CREATED SIZE
tomcat latest 9f35737a8466 30 hours ago 680MB
busybox latest beae173ccac6 3 weeks ago 1.24MB
openjdk 8-jre-alpine f7a292bbb70c 2 years ago 84.9MB
```
```shell
[root@localhost ~]# docker image inspect f7a292bbb70c
[
{
"Id": "sha256:f7a292bbb70c4ce57f7704cc03eb09e299de9da19013b084f138154421918cb4",
"RepoTags": [
"openjdk:8-jre-alpine"
],
"RepoDigests": [
"openjdk@sha256:f362b165b870ef129cbe730
.......
# 重要訊息
"Id": "sha256:f7a292bbb70c4ce57f7704cc03eb09e299de9da19013b084f138154421918cb4",
"RepoTags": [
"openjdk:8-jre-alpine"
],
"Architecture": "amd64",
"Os": "linux",
```
##### 刪除 image
```shell
# 查詢要刪除imge id
[root@localhost ~]# docker image ls
REPOSITORY TAG IMAGE ID CREATED SIZE
tomcat latest 9f35737a8466 30 hours ago 680MB
busybox latest beae173ccac6 3 weeks ago 1.24MB
openjdk 8-jre-alpine f7a292bbb70c 2 years ago 84.9MB
# 刪除 image
[root@localhost ~]# docker image rm beae173ccac6
Untagged: busybox:latest
Untagged: busybox@sha256:5acba83a746c7608ed544dc1533b87c737a0b0fb730301639a0179f9344b1678
Deleted: sha256:beae173ccac6ad749f76713cf4440fe3d21d1043fe616dfbe30775815d1d0f6a
Deleted: sha256:01fd6df81c8ec7dd24bbbd72342671f41813f992999a3471b9d9cbc44ad88374
# 刪除名字跟nginx 有關的imge (-f 強制)
[root@localhost ~]# docker images | grep nginx | awk '{print $3}' | xargs docker rmi
[root@localhost ~]# docker images | grep nginx | awk '{print $3}' | xargs docker rmi -f
# 刪除沒有名字的image (-f 強制)
[root@localhost ~]# docker images | grep "" | awk '{print $3}' | xargs docker rmi
[root@localhost ~]# docker images | grep "" | awk '{print $3}' | xargs docker rmi -f
```
##### image 匯入匯出
```shell
# 查看 image
[root@localhost ~]# docker image ls
REPOSITORY TAG IMAGE ID CREATED SIZE
tomcat latest 9f35737a8466 30 hours ago 680MB
busybox latest beae173ccac6 3 weeks ago 1.24MB
openjdk 8-jre-alpine f7a292bbb70c 2 years ago 84.9MB
# 匯出 image
# docker image save {name}:{tag} -o {匯出檔名}
[root@localhost ~]# docker image save openjdk:8-jre-alpine -o openjdk:8-jre-alpine.image
# 查看是否匯出
[root@localhost ~]# ls openjdk\:8-jre-alpine.image
openjdk:8-jre-alpine.image
```
```shell
# image 匯入
# docker image load -i {image file}
[root@localhost ~]# docker image load -i ./openjdk\:8-jre-alpine.image
f1b5933fe4b5: Loading layer [==================================================>] 5.796MB/5.796MB
9b9b7f3d56a0: Loading layer [==================================================>] 3.584kB/3.584kB
edd61588d126: Loading layer [==================================================>] 80.28MB/80.28MB
Loaded image: openjdk:8-jre-alpine
```
### push image to docker hub
```shell
# 建立上傳image
#docker image tag nginx {docker hub id}/{name}:{tag}
docker image tag nginx treemanou/my_nginx:v2
#docker image push {docker hub id}/{name}:{tag}
docker image push treemanou/my_nginx:v2
```
### commit 建立 image
```shell
# 找一個conatiner
$ docker ps -a
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
e09bb406dcef busybox "sh" 53 seconds ago Exited (0) 18 seconds ago hardcore_bartik
# 利用此container建立 image
# docker commit {container id} {name}:{tag}
$ docker commit e09 treemanou/my_busybox:v3
sha256:42bc77669110af56336ec10afdbd7f92fa371f02ecccbda1e0bbb1bbc00f3cf6
```
### Docker File
---
##### Docker File 官方說明
[Dockerfile reference | Docker Documentation](https://docs.docker.com/engine/reference/builder/)
---
\*ENV 環境變數
```
ENV ANT_HOME /opt/ant
```
\*ARG傳入參數
```
FROM alpine
ARG NODE_ARG
ENV NODE_ENV="${NODE_ARG:-development}"
RUN echo "ARG=${NODE_ARG}, ENV=${NODE_ENV}"
CMD ehco "ARG=${NODE_ARG}, ENV=${NODE_ENV}"
```
```shell
# 傳入NODE_ARG
# DOCKER_BUILDKIT=0
DOCKER_BUILDKIT=0 docker build --build-arg NODE_ARG=staging .
```
\*工作目錄 WORKDIR
```shell
# / 下
RUN echo "say hi" > hi.txt
WORKDIR /app
# /app 下
RUN echo "hello" > world.txt
```
\*指定用戶USER (不指定舊識)
```shell
# 新增 group與user
RUN groupadd -r redis && useradd -r -g redis redis
# 指定當前user為redis
USER redis
# 以redis的身份執行reidis-server
RUN ["redis-server"]
```
\*Health Check
```shell
FROM nginx
RUN apt-get update && apt-get install -y curl && rm -rf /var/lib/apt/lists/*
HEALTHCHECK --interval=5s --timeout=3s \
CMD curl -fs http://localhost/ || exit 1
```
---
```shell
FROM registry.test.com.tw/test/centos:openjdk8_tomcat8.5
ENV CATALINA_HOME /opt/tomcat
ENV SERVICE_HOME /usr/AP/fubon
ENV ANT_HOME /opt/ant
ENV JAVA_HOME /usr/lib/jvm/java-1.8.0-openjdk
ENV PATH="${PATH}:${ANT_HOME}/bin:${CATALINA_HOME}/bin"
ENV AWS_HOME="/root/aws"
RUN wget https://archive.apache.org/dist/ant/binaries/apache-ant-1.10.7-bin.tar.gz \
&& tar -zxvf apache-ant-1.10.7-bin.tar.gz \
&& rm apache-ant-1.10.7-bin.tar.gz \
&& mv apache-ant* ${ANT_HOME} \
&& yum install -y python3 \
&& pip3 install awscli --upgrade --user \
&& ln -s /usr/lib/jvm/java-1.8.0-openjdk-1.8.0.252.b09-2.el7_8.x86_64/ /usr/lib/jvm/java-1.8.0-openjdk.x86_64 \
&& yum install -y httpd php php-gd
COPY server.xml ${CATALINA_HOME}/conf/
COPY my_entrypoint.sh /my_entrypoint.sh
RUN chmod -v +x /my_entrypoint.sh
COPY --chown=user:group file* /app/
COPY server_builder.sh ${SERVICE_HOME}/
#Set Alias
RUN echo "alias cdcm='cd /usr/AP/test/cm'" >> ~/.bashrc \
&& echo "alias restartTomcat='cd /opt/tomcat/bin; ./shutdown.sh; /bin/sleep 3; ps -ef | grep '\''org.apache.catalina.startup.Bootstrap start'\'' | grep -v grep | awk '\''{print $2}'\'' | xargs kill; ./startup.sh'" >> ~/.bashrc \
&& echo "alias cmant='cd /usr/AP/test/cm/src; ant; restartTomcat'" >> ~/.bashrc \
EXPOSE 8080
CMD ["-D","FOREGROUND"]
# 預設目錄
WORKDIR /usr/AP/test/
# 一定會執行
ENTRYPOINT ["/my_entrypoint.sh"]
```
\* 複寫CMD
```
docker run --rm apache:v1 -v
```
---
多階段建置
```shell
# 建置環境
FROM alpine as build
RUN echo "hello" > mytest
# 執行環境
FROM alpine
COPY --from=build /mytest .
RUN cat /mytest
```
**Distroless Dock image** => 精簡image
---
### 常用image
#### busybox
- 提供輕量簡單的shell 的 linux 容器
##### containous/whoami
- 提供返回ip hostname 服務
```shell
vagrant@swarm-manager:~$ curl 192.168.200.10:8080
Hostname: fdf7c1354507
IP: 127.0.0.1
IP: 10.0.0.7
IP: 172.18.0.3
IP: 10.0.1.14
RemoteAddr: 10.0.0.2:36828
GET / HTTP/1.1
Host: 192.168.200.10:8080
User-Agent: curl/7.68.0
Accept: */*
```
# Docker Image Server DockerRegistry
[Day7：建立 private 的 Docker Registry - iT 邦幫忙::一起幫忙解決難題，拯救 IT 人的一天 (ithome.com.tw)](https://ithelp.ithome.com.tw/articles/10191213)
```shell
$ docker run -d -p 5000:5000 -v /home/user1/storage:/var/lib/registry --name registry registry:2
#
# -d：執行的 docker container 是 run 在背景的狀態，所以需要使用 docker logs 的指令才可以看到 log 狀態
# -p：主機的 5000 port mapping 到 container 的 5000 port
# -v：因為 push 到 docker registry 的資料是放在 container 裡面的，如果把 docker container 刪除掉 docker registry 的 Image 資料就會不見，因此需要使用 –v 參數將主機的檔案路徑 mapping 到 container 裡面的檔案路徑，這樣 docker container 被刪除 docker registry 的 Image 資料還會存在
# --name：設定 docker container 的名稱
```
##### clinet / server 都要加 daemon.json
```shell
# vim /etc/docker daemon.json
# 允許192.168.1.1:5000 (port 一定要寫) 可不走https
{
"insecure-registries":["192.168.1.1:5000"]
}
```
### 上傳 image
```shell
# 假設本機ip 192.168.1.1 (registry server)
# 下載image
docker pull busybox
# 複製image 成 mybusybox
docker push tag busybox 192.168.1.1:5000/mybusybox
# 上傳image
docker pull 192.168.1.1:5000/mybusybox
```
### 下載 image
```shell
# 假設本機ip 192.168.1.2 (docker client)
docker pull docker pull 192.168.1.1:5000/mybusybox
```
# Docker Image Server nexus
[sonatype/nexus3 - Docker Image | Docker Hub](https://hub.docker.com/r/sonatype/nexus3/)
1. *Use a docker volume*. Since docker volumes are persistent, a volume can be created specifically for this purpose. This is the recommended approach.
```
$ docker volume create --name nexus-data
$ docker run -d -p 8081:8081 --name nexus -v nexus-data:/nexus-data sonatype/nexus3
```
2. *Mount a host directory as the volume*. This is not portable, as it relies on the directory existing with correct permissions on the host. However it can be useful in certain situations where this volume needs to be assigned to certain specific underlying storage.
```
$ mkdir /some/dir/nexus-data && chown -R 200 /some/dir/nexus-data
$ docker run -d -p 8081:8081 --name nexus -v /some/dir/nexus-data:/nexus-data sonatype/nexus3
```
# Docker Network
[](https://bookstack.treemanou.com/uploads/images/gallery/2022-01/3BWF5JGV4iFGcRUR-image-1642500508897.png)
[](https://bookstack.treemanou.com/uploads/images/gallery/2022-01/VnZuBqb1rvcf8IZh-image-1642576871696.png)
建立兩容器
```shell
$ docker container run -d --rm --name box1 busybox /bin/sh -c "while true; do sleep 3600; done"
$ docker container run -d --rm --name box2 busybox /bin/sh -c "while true; do sleep 3600; done"
$ docker container ls
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
4f3303c84e53 busybox "/bin/sh -c 'while t…" 49 minutes ago Up 49 minutes box2
03494b034694 busybox "/bin/sh -c 'while t…" 49 minutes ago Up 49 minutes box1
```
### 容器間的通信->使用bridge
```shell
$ docker network ls
NETWORK ID NAME DRIVER SCOPE
1847e179a316 bridge bridge local
a647a4ad0b4f host host local
fbd81b56c009 none null local
$ docker network inspect bridge
[
{
"Name": "bridge",
"Id": "1847e179a316ee5219c951c2c21cf2c787d431d1ffb3ef621b8f0d1edd197b24",
"Created": "2021-07-01T15:28:09.265408946Z",
"Scope": "local",
"Driver": "bridge",
"EnableIPv6": false,
"IPAM": {
"Driver": "default",
"Options": null,
"Config": [
{
"Subnet": "172.17.0.0/16",
"Gateway": "172.17.0.1"
}
]
},
"Internal": false,
"Attachable": false,
"Ingress": false,
"ConfigFrom": {
"Network": ""
},
"ConfigOnly": false,
"Containers": {
"03494b034694982fa085cc4052b6c7b8b9c046f9d5f85f30e3a9e716fad20741": {
"Name": "box1",
"EndpointID": "072160448becebb7c9c333dce9bbdf7601a92b1d3e7a5820b8b35976cf4fd6ff",
"MacAddress": "02:42:ac:11:00:02",
"IPv4Address": "172.17.0.2/16",
"IPv6Address": ""
},
"4f3303c84e5391ea37db664fd08683b01decdadae636aaa1bfd7bb9669cbd8de": {
"Name": "box2",
"EndpointID": "4cf0f635d4273066acd3075ec775e6fa405034f94b88c1bcacdaae847612f2c5",
"MacAddress": "02:42:ac:11:00:03",
"IPv4Address": "172.17.0.3/16",
"IPv6Address": ""
}
},
"Options": {
"com.docker.network.bridge.default_bridge": "true",
"com.docker.network.bridge.enable_icc": "true",
"com.docker.network.bridge.enable_ip_masquerade": "true",
"com.docker.network.bridge.host_binding_ipv4": "0.0.0.0",
"com.docker.network.bridge.name": "docker0",
"com.docker.network.driver.mtu": "1500"
},
"Labels": {}
}
]
```
"IPAM": {
"Driver": "default",
"Options": null,
"Config": \[
{
"Subnet": "172.17.0.0/16 ",
"Gateway": "172.17.0.1 "
}
\]
},
"com.docker.network.bridge.name": "docker0",
```shell
# brctl 顯示bridge tool
$ brctl show
bridge name bridge id STP enabled interfaces
docker0 8000.0242759468cf no veth8c9bb82
vethd8f9afb
```
### 容器對外通訊->iptables nat
```
$ ip route
default via 10.0.2.2 dev eth0 proto dhcp metric 100
10.0.2.0/24 dev eth0 proto kernel scope link src 10.0.2.15 metric 100
172.17.0.0/16 dev docker0 proto kernel scope link src 172.17.0.1
192.168.200.0/24 dev eth1 proto kernel scope link src 192.168.200.10 metric 101
```
```
$ sudo iptables --list -t nat
Chain PREROUTING (policy ACCEPT)
target prot opt source destination
DOCKER all -- anywhere anywhere ADDRTYPE match dst-type LOCAL
Chain INPUT (policy ACCEPT)
target prot opt source destination
Chain OUTPUT (policy ACCEPT)
target prot opt source destination
DOCKER all -- anywhere !loopback/8 ADDRTYPE match dst-type LOCAL
Chain POSTROUTING (policy ACCEPT)
target prot opt source destination
MASQUERADE all -- 172.17.0.0/16 anywhere
Chain DOCKER (2 references)
target prot opt source destination
RETURN all -- anywhere anywhere
```
[](https://bookstack.treemanou.com/uploads/images/gallery/2022-01/Bzvyu502k6v1ZIkl-image-1642576581794.png)
docker network create --help
docker network create -d {driver} --gateway {gateway} --subnet {subnet} {name}
docker network create -d bridge --gateway 127.200.0.1 -subnet 172.200.0.0/16 demo
```shell
[tomcat@docker-qc html-doc]$ docker network create -d bridge mybridge
65c5ba6cbea2fa677e8dd0623a510f3461e24ccac196b7374fc5e8d03803ec9e
[tomcat@docker-qc html-doc]$ docker network ls
NETWORK ID NAME DRIVER SCOPE
780162e5fe57 bridge bridge local
3c5b59c8a708 host host local
65c5ba6cbea2 mybridge bridge local
[tomcat@docker-qc html-doc]$ docker network inspect mybridge
[
{
"Name": "mybridge",
"Id": "65c5ba6cbea2fa677e8dd0623a510f3461e24ccac196b7374fc5e8d03803ec9e",
"Created": "2022-01-18T18:44:39.95740673+08:00",
"Scope": "local",
"Driver": "bridge",
"EnableIPv6": false,
"IPAM": {
"Driver": "default",
"Options": {},
"Config": [
{
"Subnet": "172.18.0.0/16",
"Gateway": "172.18.0.1"
}
]
},
"Internal": false,
"Attachable": false,
"Ingress": false,
"ConfigFrom": {
"Network": ""
},
"ConfigOnly": false,
"Containers": {},
"Options": {},
"Labels": {}
}
]
```
```shell
# 建立連接mybridge的container (--network 不設定會用預設的)
$ docker container run -d --rm --name box3 --network mybridge busybox /bin/sh -c "while true; do sleep 3600; done"
# 既有container 連接mybridge
$ docker network connect mybridge box1
# container 中斷 mybridge
$ docker network disconnect mybridge box1
```
---
### **Network type**
- bridge
- host
- none
**bridge**: 新增一網段，橋接本地網路
**host**: 直接使用本地網路(無法看到port -> 等於直接開在本機port 80，好處不用nat，壞處只能開一個)
```shell
#docker dontainer run -d --name {container name} --network {network type} {image}
docker dontainer run -d --name web --network host nginx
```
[](https://bookstack.treemanou.com/uploads/images/gallery/2022-01/YfM2Dcw8nqoK2c7T-image-1642651291388.png)
只能開一個，多開會報錯
[](https://bookstack.treemanou.com/uploads/images/gallery/2022-01/BW5D4QWEKWICxDLA-image-1642651575691.png)
**none**: 只有 lookback 127.0.0.1 沒有其他網路
---
### 網路命名空間
- ##### bridge tool : brctl 安裝
```shell
#Ubuntu
apt-get install bridge-utils
#Centos
sudo yum install bridge-utils
```
[](https://bookstack.treemanou.com/uploads/images/gallery/2022-01/jrMYPAmozUFUHgTx-image-1642659997529.png)
創建bridge
```shell
[vagrant@docker-host1 ~]$ sudo brctl addbr mydocker0
[vagrant@docker-host1 ~]$ brctl show
bridge name bridge id STP enabled interfaces
mydocker0 8000.000000000000 no
[vagrant@docker-host1 ~]$
```
add-ns-to-br.sh
```shell
#!/bin/bash
bridge=$1
namespace=$2
addr=$3
vethA=veth-$namespace
vethB=eth00
sudo ip netns add $namespace
sudo ip link add $vethA type veth peer name $vethB
sudo ip link set $vethB netns $namespace
sudo ip netns exec $namespace ip addr add $addr dev $vethB
sudo ip netns exec $namespace ip link set $vethB up
sudo ip link set $vethA up
sudo brctl addif $bridge $vethA
```
```shell
#run shell
[vagrant@docker-host1 ~]$ sh add-ns-to-br.sh mydocker0 ns1 172.16.1.1/16
[vagrant@docker-host1 ~]$ sh add-ns-to-br.sh mydocker0 ns2 172.16.1.2/16
#up bridge
[vagrant@docker-host1 ~]$ sudo ip link set dev mydocker0 up
```
驗證
```shell
[vagrant@docker-host1 ~]$ sudo ip netns exec ns1 bash
[root@docker-host1 vagrant]# ip a
1: lo: mtu 65536 qdisc noop state DOWN group default qlen 1000
link/loopback 00:00:00:00:00:00 brd 00:00:00:00:00:00
5: eth00@if6: mtu 1500 qdisc noqueue state UP group default qlen 1000
link/ether f2:59:19:34:73:70 brd ff:ff:ff:ff:ff:ff link-netnsid 0
inet 172.16.1.1/16 scope global eth00
valid_lft forever preferred_lft forever
inet6 fe80::f059:19ff:fe34:7370/64 scope link
valid_lft forever preferred_lft forever
[root@docker-host1 vagrant]# ping 172.16.1.2
PING 172.16.1.2 (172.16.1.2) 56(84) bytes of data.
64 bytes from 172.16.1.2: icmp_seq=1 ttl=64 time=0.029 ms
64 bytes from 172.16.1.2: icmp_seq=2 ttl=64 time=0.080 ms
^C
--- 172.16.1.2 ping statistics ---
2 packets transmitted, 2 received, 0% packet loss, time 1000ms
rtt min/avg/max/mdev = 0.029/0.054/0.080/0.026 ms
[root@docker-host1 vagrant]#
```
[](https://bookstack.treemanou.com/uploads/images/gallery/2022-01/J47bjgngTUMyQynn-image-1642660373795.png)
[](https://bookstack.treemanou.com/uploads/images/gallery/2022-01/96PF3Lseg7J1VaxD-image-1642660418946.png)
使用iptables 實現nat
[NAT with Linux and iptables - Tutorial (Introduction) (karlrupp.net)](https://www.karlrupp.net/en/computer/nat_tutorial)
---
### 使用自定義網路練習
使用自定義網路，預設自帶dns，容器間可相互使用name ping 通
準備python 檔案 **app.py**
```Python
from flask import Flask
from redis import Redis
import os
import socket
app = Flask(__name__)
redis = Redis(host=os.environ.get('REDIS_HOST', '127.0.0.1'), port=6379)
@app.route('/')
def hello():
redis.incr('hits')
return f"Hello Container World! I have been seen {redis.get('hits').decode('utf-8')} times and my hostname is {socket.gethostname()}.\n"
```
準備一個 Dockerfile
```shell
FROM python:3.9.5-slim
RUN pip install flask redis && \
groupadd -r flask && useradd -r -g flask flask && \
mkdir /src && \
chown -R flask:flask /src
USER flask
COPY app.py /src/app.py
WORKDIR /src
ENV FLASK_APP=app.py REDIS_HOST=redis
EXPOSE 5000
CMD ["flask", "run", "-h", "0.0.0.0"]
```
build image 並下載一個redis image
```shell
$ docker image pull redis
$ docker image build -t flask-demo .
$ docker image ls
REPOSITORY TAG IMAGE ID CREATED SIZE
flask-demo latest 4778411a24c5 About a minute ago 126MB
python 3.9.5-slim c71955050276 8 days ago 115MB
redis latest 08502081bff6 2 weeks ago 105MB
```
建立一個bridge
```shell
$ docker network create -d bridge demo-network
8005f4348c44ffe3cdcbbda165beea2b0cb520179d3745b24e8f9e05a3e6456d
$ docker network ls
NETWORK ID NAME DRIVER SCOPE
2a464c0b8ec7 bridge bridge local
8005f4348c44 demo-network bridge local
80b63f711a37 host host local
fae746a75be1 none null local
```
建立redis container 並連至 demo-network
```shell
$ docker container run -d --name redis-server --network demo-network redis
002800c265020310231d689e6fd35bc084a0fa015e8b0a3174aa2c5e29824c0e
$ docker container ls
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
002800c26502 redis "docker-entrypoint.s…" 4 seconds ago Up 3 seconds 6379/tcp redis-server
```
建立 flask container
```shell
$ docker container run -d --network demo-network --name flask-demo --env REDIS_HOST=redis-server -p 5000:5000 flask-demo
```
打開瀏覽器 [http://127.0.0.1:5000](http://127.0.0.1:5000/)
可以看到以下內容，每次刷新次次就會+1
Hello Container World! I have been seen 36 times and my hostname is 925ecb8d111a.
##### 整理後腳本
```shell
# prepare image
docker image pull redis
docker image build -t flask-demo .
# create network
docker network create -d bridge demo-network
# create container
docker container run -d --name redis-server --network demo-network redis
docker container run -d --network demo-network --name flask-demo --env REDIS_HOST=redis-server -p 5000:5000 flask-demo
```
# Docker Swarm
### 相關指令
```shell
# 查詢swarm狀態
docker info
# 未開啟
Swarm: inactive
# 初始化swarm
docker swarm init
##########################
Swarm initialized: current node (4szs3vf8x9pb79me4cxfsb9m2) is now a manager.
To add a worker to this swarm, run the following command:
#加入叢集使用以下命令
docker swarm join --token SWMTKN-1-3i2aq39bqqudp6p6y3o4ubw4ca1036z85z3huf9lyfijdfns88-33y43c8gw2ch85wbl2jdb4w0e 192.168.65.6:2377
To add a manager to this swarm, run 'docker swarm join-token manager' and follow the instructions.
##########################
#查詢節點
docker node ls
ID HOSTNAME STATUS AVAILABILITY MANAGER STATUS ENGINE VERSION
4szs3vf8x9pb79me4cxfsb9m2 * docker-desktop Ready Active Leader 20.10.6
# 開啟後查詢 docker info
Swarm: active
NodeID: 4szs3vf8x9pb79me4cxfsb9m2
Is Manager: true
ClusterID: 83phccx66ca4rji17wk8p5kce
Managers: 1
Nodes: 1
Default Address Pool: 10.0.0.0/8
SubnetSize: 24
Data Path Port: 4789
Orchestration:
# 離開docker swarm 叢集
docker swrm leave -f
```
### docker swarm init 背後發生了什麼
主要是PKI和安全相關的自動化
- 創建swarm集群的根證書
- manager節點的證書
- 其它節點加入集群需要的tokens
創建Raft資料庫用於存儲證書，配置，密碼等數據
---
### 建立一個service(container)
```shell
# docker service create {image}:{tag}
docker service create --name web nginx:latest
```
```shell
# 取得servie id(不是container id)
docker service ls
ID NAME MODE REPLICAS IMAGE PORTS
l5wvuxzw9l96 jolly_euclid replicated 1/1 nginx:latest
# 查看container
docker service ps l5wvuxzw9l96
ID NAME IMAGE NODE DESIRED STATE CURRENT STATE ERROR PORTS
vp8dkrsqslxw jolly_euclid.1 nginx:latest docker-desktop Running Running 3 minutes ago
# 建立3個副本(update)
docker service update l5wvuxzw9l96 --replicas 3
l5wvuxzw9l96
overall progress: 3 out of 3 tasks
1/3: running [==================================================>]
2/3: running [==================================================>]
3/3: running [==================================================>]
# 建立4個副本(scale)
docker service scale l5wvuxzw9l96=4
web scaled to 4
overall progress: 4 out of 4 tasks
1/4: running [==================================================>]
2/4: running [==================================================>]
3/4: running [==================================================>]
4/4: running [==================================================>]
#docker sercie ps
docker service ps l5wvuxzw9l96
ID NAME IMAGE NODE DESIRED STATE CURRENT STATE ERROR PORTS
vp8dkrsqslxw jolly_euclid.1 nginx:latest docker-desktop Running Running 13 minutes ago
qavp0npxko3l jolly_euclid.2 nginx:latest docker-desktop Running Running 7 minutes ago
kqs6uvbkxmjh jolly_euclid.3 nginx:latest docker-desktop Running Running 7 minutes ago
```
### service 刪除
```shell
docker service rm l5wvuxzw9l96
```
---
### docker swarm的網路：
- 第一是外部如何訪問部署運行在swarm集群內的服務，可以稱之為 `入方向 ` 流量，在swarm裡我們通過 `ingress ` 來解決
- 第二是部署在swarm集群裡的服務，如何對外進行訪問，這部分又分為兩塊:
- 第一，`東西向流量 ` ，也就是不同swarm節點上的容器之間如何通信，swarm通過 `overlay ` 網絡來解決；
- 第二，`南北向流量 ` ，也就是swarm集群裡的容器如何對外訪問，比如互聯網，這個是 `Linux bridge + iptables NAT ` 來解決的
[](https://bookstack.treemanou.com/uploads/images/gallery/2022-02/nxC5u1ibHLND7LXz-image-1644943091590.png)
# Docker如何固定IP設定的方法
[Docker如何固定IP設定的方法 - IT閱讀 (itread01.com)](https://www.itread01.com/article/1499743916.html)
經常用Docker模擬專案在生產環境中的部署，往往需要同時開好幾臺Docker容器，而且有時安裝的軟體需要繫結Docker區域網中的其他容器，如 MongoDB 副本集部署的時候，就需要繫結其他容器的內網IP。
但是，Docker 每次重啟後，容器的IP地址會變化，查詢了資料，Docker是支援設定固定IP的。
**Docker 預設網路**
Docker安裝後，預設會建立下面三種網路型別：
```
$ docker network ls
NETWORK ID NAME DRIVER SCOPE
9781b1f585ae bridge bridge local
1252da701e55 host host local
237ea3d5cfbf none null local
```
啟動 Docker的時候，用 `--network `引數，可以指定網路型別，如：
```
~ docker run - itd -- name test1 -- network bridge -- ip 172.17 . 0.10 centos : latest / bin / bash
```
**bridge：橋接網路**
預設情況下啟動的Docker容器，都是使用 bridge，Docker安裝時建立的橋接網路，每次Docker容器重啟時，會按照順序獲取對應的IP地址，這個就導致重啟下，Docker的IP地址就變了
**none：無指定網路**
使用 `--network=none `，docker 容器就不會分配區域網的IP
**host： 主機網路**
使用 `--network=host`，此時，Docker 容器的網路會附屬在主機上，兩者是互通的。
例如，在容器中執行一個Web服務，監聽8080埠，則主機的8080埠就會自動對映到容器中。
**建立自定義網路：（設定固定IP）**
啟動Docker容器的時候，使用預設的網路是不支援指派固定IP的，如下：
```
~ docker run - itd -- net bridge -- ip 172.17 . 0.10 centos : latest / bin / bash
6eb1f228cf308d1c60db30093c126acbfd0cb21d76cb448c678bab0f1a7c0df6
docker : Error response from daemon : User specified IP address is supported on user defined networks only .
```
因此，需要建立自定義網路，下面是具體的步驟：
**步驟1: 建立自定義網路**
建立自定義網路，並且指定網段：172.18.0.0/16
```
➜ ~ docker network create -- subnet = 172.18 . 0.0 / 16 mynetwork
➜ ~ docker network ls
NETWORK ID NAME DRIVER SCOPE
9781b1f585ae bridge bridge local
1252da701e55 host host local
4f11ae9c85de mynetwork bridge local
237ea3d5cfbf none null local
```
**步驟2: 建立Docker容器**
```
[ root@ec8e31938fe7 /]# ifconfig
eth0 Link encap : Ethernet HWaddr 02 : 42 : AC : 12 : 00 : 02
inet addr : 172.18 . 0.2 Bcast : 0.0 . 0.0 Mask : 255.255 . 0.0
inet6 addr : fe80 :: 42 : acff : fe12 : 2 / 64 Scope : Link
UP BROADCAST RUNNING MULTICAST MTU : 1500 Metric : 1
RX packets : 88 errors : 0 dropped : 0 overruns : 0 frame : 0
TX packets : 14 errors : 0 dropped : 0 overruns : 0 carrier : 0
collisions : 0 txqueuelen : 0
RX bytes : 4056 ( 3.9 KiB ) TX bytes : 1068 ( 1.0 KiB )
lo Link encap : Local Loopback
inet addr : 127.0 . 0.1 Mask : 255.0 . 0.0
inet6 addr : :: 1 / 128 Scope : Host
UP LOOPBACK RUNNING MTU : 65536 Metric : 1
RX packets : 0 errors : 0 dropped : 0 overruns : 0 frame : 0
TX packets : 0 errors : 0 dropped : 0 overruns : 0 carrier : 0
collisions : 0 txqueuelen : 1
RX bytes : 0 ( 0.0 b ) TX bytes : 0 ( 0.0 b )
```
# Docker安裝
### Centos
[Docker Engine on CentOS | Docker Documentation](https://docs.docker.com/engine/install/centos/)
```highlight
sudo yum remove docker \
docker-client \
docker-client-latest \
docker-common \
docker-latest \
docker-latest-logrotate \
docker-logrotate \
docker-engine
```
```
sudo yum install -y yum-utils
sudo yum-config-manager \
--add-repo \
https://download.docker.com/linux/centos/docker-ce.repo
```
```
sudo yum-config-manager --enable docker-ce-nightly
sudo yum install docker-ce docker-ce-cli containerd.io
sudo systemctl start docker
sudo systemctl enable docker
```
~/.docker/config.json
```
{
"proxies":
{
"default":
{
"httpProxy": "http://192.168.1.12:3128",
"httpsProxy": "http://192.168.1.12:3128",
"noProxy": "*.test.example.com,.example2.com,127.0.0.0/8"
}
}
}
```
/etc/docker/daemon.json
```
{
"registry-mirrors":["http://hub-mirror.c.163.com"],
}
```
```
registry-1.docker.io. 54 IN A 34.197.211.151
registry-1.docker.io. 54 IN A 34.192.145.113
registry-1.docker.io. 54 IN A 18.214.230.110
registry-1.docker.io. 54 IN A 52.55.168.20
registry-1.docker.io. 54 IN A 3.229.227.53
registry-1.docker.io. 54 IN A 3.209.182.229
registry-1.docker.io. 54 IN A 3.213.204.48
registry-1.docker.io. 54 IN A 54.161.109.204
```
```
mkdir /etc/systemd/system/docker.service.d
vim /etc/systemd/system/docker.service.d/http-proxy.conf
########################################################
[Service]
Environment="HTTP_PROXY=http://proxy.example.com:80/"
Environment="NO_PROXY=localhost,127.0.0.0/8,docker-registry.somecorporation.com"
########################################################
sudo systemctl daemon-reload
sudo systemctl show --property Environment docker
sudo systemctl restart docker
```
---
### 使用get.docker.com 腳本
[https://get.docker.com](https://get.docker.com/)
```shell
curl -L get.docker.com -o get-docker.sh
sh get-docker.sh
```
```shell
#!/bin/sh
set -e
# Docker CE for Linux installation script
#
# See https://docs.docker.com/engine/install/ for the installation steps.
#
# This script is meant for quick & easy install via:
# $ curl -fsSL https://get.docker.com -o get-docker.sh
# $ sh get-docker.sh
#
# For test builds (ie. release candidates):
# $ curl -fsSL https://test.docker.com -o test-docker.sh
# $ sh test-docker.sh
#
# NOTE: Make sure to verify the contents of the script
# you downloaded matches the contents of install.sh
# located at https://github.com/docker/docker-install
# before executing.
#
# Git commit from https://github.com/docker/docker-install when
# the script was uploaded (Should only be modified by upload job):
SCRIPT_COMMIT_SHA="93d2499759296ac1f9c510605fef85052a2c32be"
# strip "v" prefix if present
VERSION="${VERSION#v}"
# The channel to install from:
# * nightly
# * test
# * stable
# * edge (deprecated)
DEFAULT_CHANNEL_VALUE="stable"
if [ -z "$CHANNEL" ]; then
CHANNEL=$DEFAULT_CHANNEL_VALUE
fi
DEFAULT_DOWNLOAD_URL="https://download.docker.com"
if [ -z "$DOWNLOAD_URL" ]; then
DOWNLOAD_URL=$DEFAULT_DOWNLOAD_URL
fi
DEFAULT_REPO_FILE="docker-ce.repo"
if [ -z "$REPO_FILE" ]; then
REPO_FILE="$DEFAULT_REPO_FILE"
fi
mirror=''
DRY_RUN=${DRY_RUN:-}
while [ $# -gt 0 ]; do
case "$1" in
--mirror)
mirror="$2"
shift
;;
--dry-run)
DRY_RUN=1
;;
--*)
echo "Illegal option $1"
;;
esac
shift $(( $# > 0 ? 1 : 0 ))
done
case "$mirror" in
Aliyun)
DOWNLOAD_URL="https://mirrors.aliyun.com/docker-ce"
;;
AzureChinaCloud)
DOWNLOAD_URL="https://mirror.azure.cn/docker-ce"
;;
esac
command_exists() {
command -v "$@" > /dev/null 2>&1
}
# version_gte checks if the version specified in $VERSION is at least
# the given CalVer (YY.MM) version. returns 0 (success) if $VERSION is either
# unset (=latest) or newer or equal than the specified version. Returns 1 (fail)
# otherwise.
#
# examples:
#
# VERSION=20.10
# version_gte 20.10 // 0 (success)
# version_gte 19.03 // 0 (success)
# version_gte 21.10 // 1 (fail)
version_gte() {
if [ -z "$VERSION" ]; then
return 0
fi
eval calver_compare "$VERSION" "$1"
}
# calver_compare compares two CalVer (YY.MM) version strings. returns 0 (success)
# if version A is newer or equal than version B, or 1 (fail) otherwise. Patch
# releases and pre-release (-alpha/-beta) are not taken into account
#
# examples:
#
# calver_compare 20.10 19.03 // 0 (success)
# calver_compare 20.10 20.10 // 0 (success)
# calver_compare 19.03 20.10 // 1 (fail)
calver_compare() (
set +x
yy_a="$(echo "$1" | cut -d'.' -f1)"
yy_b="$(echo "$2" | cut -d'.' -f1)"
if [ "$yy_a" -lt "$yy_b" ]; then
return 1
fi
if [ "$yy_a" -gt "$yy_b" ]; then
return 0
fi
mm_a="$(echo "$1" | cut -d'.' -f2)"
mm_b="$(echo "$2" | cut -d'.' -f2)"
if [ "${mm_a#0}" -lt "${mm_b#0}" ]; then
return 1
fi
return 0
)
is_dry_run() {
if [ -z "$DRY_RUN" ]; then
return 1
else
return 0
fi
}
is_wsl() {
case "$(uname -r)" in
*microsoft* ) true ;; # WSL 2
*Microsoft* ) true ;; # WSL 1
* ) false;;
esac
}
is_darwin() {
case "$(uname -s)" in
*darwin* ) true ;;
*Darwin* ) true ;;
* ) false;;
esac
}
deprecation_notice() {
distro=$1
distro_version=$2
echo
printf "\033[91;1mDEPRECATION WARNING\033[0m\n"
printf " This Linux distribution (\033[1m%s %s\033[0m) reached end-of-life and is no longer supported by this script.\n" "$distro" "$distro_version"
echo " No updates or security fixes will be released for this distribution, and users are recommended"
echo " to upgrade to a currently maintained version of $distro."
echo
printf "Press \033[1mCtrl+C\033[0m now to abort this script, or wait for the installation to continue."
echo
sleep 10
}
get_distribution() {
lsb_dist=""
# Every system that we officially support has /etc/os-release
if [ -r /etc/os-release ]; then
lsb_dist="$(. /etc/os-release && echo "$ID")"
fi
# Returning an empty string here should be alright since the
# case statements don't act unless you provide an actual value
echo "$lsb_dist"
}
echo_docker_as_nonroot() {
if is_dry_run; then
return
fi
if command_exists docker && [ -e /var/run/docker.sock ]; then
(
set -x
$sh_c 'docker version'
) || true
fi
# intentionally mixed spaces and tabs here -- tabs are stripped by "<<-EOF", spaces are kept in the output
echo
echo "================================================================================"
echo
if version_gte "20.10"; then
echo "To run Docker as a non-privileged user, consider setting up the"
echo "Docker daemon in rootless mode for your user:"
echo
echo " dockerd-rootless-setuptool.sh install"
echo
echo "Visit https://docs.docker.com/go/rootless/ to learn about rootless mode."
echo
fi
echo
echo "To run the Docker daemon as a fully privileged service, but granting non-root"
echo "users access, refer to https://docs.docker.com/go/daemon-access/"
echo
echo "WARNING: Access to the remote API on a privileged Docker daemon is equivalent"
echo " to root access on the host. Refer to the 'Docker daemon attack surface'"
echo " documentation for details: https://docs.docker.com/go/attack-surface/"
echo
echo "================================================================================"
echo
}
# Check if this is a forked Linux distro
check_forked() {
# Check for lsb_release command existence, it usually exists in forked distros
if command_exists lsb_release; then
# Check if the `-u` option is supported
set +e
lsb_release -a -u > /dev/null 2>&1
lsb_release_exit_code=$?
set -e
# Check if the command has exited successfully, it means we're in a forked distro
if [ "$lsb_release_exit_code" = "0" ]; then
# Print info about current distro
cat <<-EOF
You're using '$lsb_dist' version '$dist_version'.
EOF
# Get the upstream release info
lsb_dist=$(lsb_release -a -u 2>&1 | tr '[:upper:]' '[:lower:]' | grep -E 'id' | cut -d ':' -f 2 | tr -d '[:space:]')
dist_version=$(lsb_release -a -u 2>&1 | tr '[:upper:]' '[:lower:]' | grep -E 'codename' | cut -d ':' -f 2 | tr -d '[:space:]')
# Print info about upstream distro
cat <<-EOF
Upstream release is '$lsb_dist' version '$dist_version'.
EOF
else
if [ -r /etc/debian_version ] && [ "$lsb_dist" != "ubuntu" ] && [ "$lsb_dist" != "raspbian" ]; then
if [ "$lsb_dist" = "osmc" ]; then
# OSMC runs Raspbian
lsb_dist=raspbian
else
# We're Debian and don't even know it!
lsb_dist=debian
fi
dist_version="$(sed 's/\/.*//' /etc/debian_version | sed 's/\..*//')"
case "$dist_version" in
11)
dist_version="bullseye"
;;
10)
dist_version="buster"
;;
9)
dist_version="stretch"
;;
8)
dist_version="jessie"
;;
esac
fi
fi
fi
}
do_install() {
echo "# Executing docker install script, commit: $SCRIPT_COMMIT_SHA"
if command_exists docker; then
cat >&2 <<-'EOF'
Warning: the "docker" command appears to already exist on this system.
If you already have Docker installed, this script can cause trouble, which is
why we're displaying this warning and provide the opportunity to cancel the
installation.
If you installed the current Docker package using this script and are using it
again to update Docker, you can safely ignore this message.
You may press Ctrl+C now to abort this script.
EOF
( set -x; sleep 20 )
fi
user="$(id -un 2>/dev/null || true)"
sh_c='sh -c'
if [ "$user" != 'root' ]; then
if command_exists sudo; then
sh_c='sudo -E sh -c'
elif command_exists su; then
sh_c='su -c'
else
cat >&2 <<-'EOF'
Error: this installer needs the ability to run commands as root.
We are unable to find either "sudo" or "su" available to make this happen.
EOF
exit 1
fi
fi
if is_dry_run; then
sh_c="echo"
fi
# perform some very rudimentary platform detection
lsb_dist=$( get_distribution )
lsb_dist="$(echo "$lsb_dist" | tr '[:upper:]' '[:lower:]')"
if is_wsl; then
echo
echo "WSL DETECTED: We recommend using Docker Desktop for Windows."
echo "Please get Docker Desktop from https://www.docker.com/products/docker-desktop"
echo
cat >&2 <<-'EOF'
You may press Ctrl+C now to abort this script.
EOF
( set -x; sleep 20 )
fi
case "$lsb_dist" in
ubuntu)
if command_exists lsb_release; then
dist_version="$(lsb_release --codename | cut -f2)"
fi
if [ -z "$dist_version" ] && [ -r /etc/lsb-release ]; then
dist_version="$(. /etc/lsb-release && echo "$DISTRIB_CODENAME")"
fi
;;
debian|raspbian)
dist_version="$(sed 's/\/.*//' /etc/debian_version | sed 's/\..*//')"
case "$dist_version" in
11)
dist_version="bullseye"
;;
10)
dist_version="buster"
;;
9)
dist_version="stretch"
;;
8)
dist_version="jessie"
;;
esac
;;
centos|rhel|sles)
if [ -z "$dist_version" ] && [ -r /etc/os-release ]; then
dist_version="$(. /etc/os-release && echo "$VERSION_ID")"
fi
;;
*)
if command_exists lsb_release; then
dist_version="$(lsb_release --release | cut -f2)"
fi
if [ -z "$dist_version" ] && [ -r /etc/os-release ]; then
dist_version="$(. /etc/os-release && echo "$VERSION_ID")"
fi
;;
esac
# Check if this is a forked Linux distro
check_forked
# Print deprecation warnings for distro versions that recently reached EOL,
# but may still be commonly used (especially LTS versions).
case "$lsb_dist.$dist_version" in
debian.stretch|debian.jessie)
deprecation_notice "$lsb_dist" "$dist_version"
;;
raspbian.stretch|raspbian.jessie)
deprecation_notice "$lsb_dist" "$dist_version"
;;
ubuntu.xenial|ubuntu.trusty)
deprecation_notice "$lsb_dist" "$dist_version"
;;
fedora.*)
if [ "$dist_version" -lt 33 ]; then
deprecation_notice "$lsb_dist" "$dist_version"
fi
;;
esac
# Run setup for each distro accordingly
case "$lsb_dist" in
ubuntu|debian|raspbian)
pre_reqs="apt-transport-https ca-certificates curl"
if ! command -v gpg > /dev/null; then
pre_reqs="$pre_reqs gnupg"
fi
apt_repo="deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] $DOWNLOAD_URL/linux/$lsb_dist $dist_version $CHANNEL"
(
if ! is_dry_run; then
set -x
fi
$sh_c 'apt-get update -qq >/dev/null'
$sh_c "DEBIAN_FRONTEND=noninteractive apt-get install -y -qq $pre_reqs >/dev/null"
$sh_c "curl -fsSL \"$DOWNLOAD_URL/linux/$lsb_dist/gpg\" | gpg --dearmor --yes -o /usr/share/keyrings/docker-archive-keyring.gpg"
$sh_c "echo \"$apt_repo\" > /etc/apt/sources.list.d/docker.list"
$sh_c 'apt-get update -qq >/dev/null'
)
pkg_version=""
if [ -n "$VERSION" ]; then
if is_dry_run; then
echo "# WARNING: VERSION pinning is not supported in DRY_RUN"
else
# Will work for incomplete versions IE (17.12), but may not actually grab the "latest" if in the test channel
pkg_pattern="$(echo "$VERSION" | sed "s/-ce-/~ce~.*/g" | sed "s/-/.*/g").*-0~$lsb_dist"
search_command="apt-cache madison 'docker-ce' | grep '$pkg_pattern' | head -1 | awk '{\$1=\$1};1' | cut -d' ' -f 3"
pkg_version="$($sh_c "$search_command")"
echo "INFO: Searching repository for VERSION '$VERSION'"
echo "INFO: $search_command"
if [ -z "$pkg_version" ]; then
echo
echo "ERROR: '$VERSION' not found amongst apt-cache madison results"
echo
exit 1
fi
if version_gte "18.09"; then
search_command="apt-cache madison 'docker-ce-cli' | grep '$pkg_pattern' | head -1 | awk '{\$1=\$1};1' | cut -d' ' -f 3"
echo "INFO: $search_command"
cli_pkg_version="=$($sh_c "$search_command")"
fi
pkg_version="=$pkg_version"
fi
fi
(
pkgs=""
if version_gte "18.09"; then
# older versions don't support a cli package
pkgs="$pkgs docker-ce-cli${cli_pkg_version%=}"
fi
if version_gte "20.10" && [ "$(uname -m)" = "x86_64" ]; then
# also install the latest version of the "docker scan" cli-plugin (only supported on x86 currently)
pkgs="$pkgs docker-scan-plugin"
fi
pkgs="$pkgs docker-ce${pkg_version%=}"
if ! is_dry_run; then
set -x
fi
$sh_c "DEBIAN_FRONTEND=noninteractive apt-get install -y -qq --no-install-recommends $pkgs >/dev/null"
if version_gte "20.10"; then
# Install docker-ce-rootless-extras without "--no-install-recommends", so as to install slirp4netns when available
$sh_c "DEBIAN_FRONTEND=noninteractive apt-get install -y -qq docker-ce-rootless-extras${pkg_version%=} >/dev/null"
fi
)
echo_docker_as_nonroot
exit 0
;;
centos|fedora|rhel)
if [ "$(uname -m)" != "s390x" ] && [ "$lsb_dist" = "rhel" ]; then
echo "Packages for RHEL are currently only available for s390x."
exit 1
fi
yum_repo="$DOWNLOAD_URL/linux/$lsb_dist/$REPO_FILE"
if ! curl -Ifs "$yum_repo" > /dev/null; then
echo "Error: Unable to curl repository file $yum_repo, is it valid?"
exit 1
fi
if [ "$lsb_dist" = "fedora" ]; then
pkg_manager="dnf"
config_manager="dnf config-manager"
enable_channel_flag="--set-enabled"
disable_channel_flag="--set-disabled"
pre_reqs="dnf-plugins-core"
pkg_suffix="fc$dist_version"
else
pkg_manager="yum"
config_manager="yum-config-manager"
enable_channel_flag="--enable"
disable_channel_flag="--disable"
pre_reqs="yum-utils"
pkg_suffix="el"
fi
(
if ! is_dry_run; then
set -x
fi
$sh_c "$pkg_manager install -y -q $pre_reqs"
$sh_c "$config_manager --add-repo $yum_repo"
if [ "$CHANNEL" != "stable" ]; then
$sh_c "$config_manager $disable_channel_flag docker-ce-*"
$sh_c "$config_manager $enable_channel_flag docker-ce-$CHANNEL"
fi
$sh_c "$pkg_manager makecache"
)
pkg_version=""
if [ -n "$VERSION" ]; then
if is_dry_run; then
echo "# WARNING: VERSION pinning is not supported in DRY_RUN"
else
pkg_pattern="$(echo "$VERSION" | sed "s/-ce-/\\\\.ce.*/g" | sed "s/-/.*/g").*$pkg_suffix"
search_command="$pkg_manager list --showduplicates 'docker-ce' | grep '$pkg_pattern' | tail -1 | awk '{print \$2}'"
pkg_version="$($sh_c "$search_command")"
echo "INFO: Searching repository for VERSION '$VERSION'"
echo "INFO: $search_command"
if [ -z "$pkg_version" ]; then
echo
echo "ERROR: '$VERSION' not found amongst $pkg_manager list results"
echo
exit 1
fi
if version_gte "18.09"; then
# older versions don't support a cli package
search_command="$pkg_manager list --showduplicates 'docker-ce-cli' | grep '$pkg_pattern' | tail -1 | awk '{print \$2}'"
cli_pkg_version="$($sh_c "$search_command" | cut -d':' -f 2)"
fi
# Cut out the epoch and prefix with a '-'
pkg_version="-$(echo "$pkg_version" | cut -d':' -f 2)"
fi
fi
(
if ! is_dry_run; then
set -x
fi
# install the correct cli version first
if [ -n "$cli_pkg_version" ]; then
$sh_c "$pkg_manager install -y -q docker-ce-cli-$cli_pkg_version"
fi
$sh_c "$pkg_manager install -y -q docker-ce$pkg_version"
if version_gte "20.10"; then
$sh_c "$pkg_manager install -y -q docker-ce-rootless-extras$pkg_version"
fi
)
echo_docker_as_nonroot
exit 0
;;
sles)
if [ "$(uname -m)" != "s390x" ]; then
echo "Packages for SLES are currently only available for s390x"
exit 1
fi
sles_version="${dist_version##*.}"
sles_repo="$DOWNLOAD_URL/linux/$lsb_dist/$REPO_FILE"
opensuse_repo="https://download.opensuse.org/repositories/security:SELinux/SLE_15_SP$sles_version/security:SELinux.repo"
if ! curl -Ifs "$sles_repo" > /dev/null; then
echo "Error: Unable to curl repository file $sles_repo, is it valid?"
exit 1
fi
pre_reqs="ca-certificates curl libseccomp2 awk"
(
if ! is_dry_run; then
set -x
fi
$sh_c "zypper install -y $pre_reqs"
$sh_c "zypper addrepo $sles_repo"
if ! is_dry_run; then
cat >&2 <<-'EOF'
WARNING!!
openSUSE repository (https://download.opensuse.org/repositories/security:SELinux) will be enabled now.
Do you wish to continue?
You may press Ctrl+C now to abort this script.
EOF
( set -x; sleep 30 )
fi
$sh_c "zypper addrepo $opensuse_repo"
$sh_c "zypper --gpg-auto-import-keys refresh"
$sh_c "zypper lr -d"
)
pkg_version=""
if [ -n "$VERSION" ]; then
if is_dry_run; then
echo "# WARNING: VERSION pinning is not supported in DRY_RUN"
else
pkg_pattern="$(echo "$VERSION" | sed "s/-ce-/\\\\.ce.*/g" | sed "s/-/.*/g")"
search_command="zypper search -s --match-exact 'docker-ce' | grep '$pkg_pattern' | tail -1 | awk '{print \$6}'"
pkg_version="$($sh_c "$search_command")"
echo "INFO: Searching repository for VERSION '$VERSION'"
echo "INFO: $search_command"
if [ -z "$pkg_version" ]; then
echo
echo "ERROR: '$VERSION' not found amongst zypper list results"
echo
exit 1
fi
search_command="zypper search -s --match-exact 'docker-ce-cli' | grep '$pkg_pattern' | tail -1 | awk '{print \$6}'"
# It's okay for cli_pkg_version to be blank, since older versions don't support a cli package
cli_pkg_version="$($sh_c "$search_command")"
pkg_version="-$pkg_version"
search_command="zypper search -s --match-exact 'docker-ce-rootless-extras' | grep '$pkg_pattern' | tail -1 | awk '{print \$6}'"
rootless_pkg_version="$($sh_c "$search_command")"
rootless_pkg_version="-$rootless_pkg_version"
fi
fi
(
if ! is_dry_run; then
set -x
fi
# install the correct cli version first
if [ -n "$cli_pkg_version" ]; then
$sh_c "zypper install -y docker-ce-cli-$cli_pkg_version"
fi
$sh_c "zypper install -y docker-ce$pkg_version"
if version_gte "20.10"; then
$sh_c "zypper install -y docker-ce-rootless-extras$rootless_pkg_version"
fi
)
echo_docker_as_nonroot
exit 0
;;
*)
if [ -z "$lsb_dist" ]; then
if is_darwin; then
echo
echo "ERROR: Unsupported operating system 'macOS'"
echo "Please get Docker Desktop from https://www.docker.com/products/docker-desktop"
echo
exit 1
fi
fi
echo
echo "ERROR: Unsupported distribution '$lsb_dist'"
echo
exit 1
;;
esac
exit 1
}
# wrapped up in a function so that we have some protection against only getting
# half the file during "curl | sh"
do_install
```
# Docker架構
[](https://bookstack.treemanou.com/uploads/images/gallery/2022-02/XEObQQ2Bh4FolaIj-image-1644994790311.png)
[](https://bookstack.treemanou.com/uploads/images/gallery/2022-02/5xLhezmrYbZpz2O4-image-1644994815207.png)
[](https://bookstack.treemanou.com/uploads/images/gallery/2022-02/4KpqHL7bW0Xqz794-image-1644994935799.png)
# Docker常用指令
[](https://bookstack.treemanou.com/uploads/images/gallery/2022-01/yQqsC2nE74AEf4ci-image-1641898072150.png)
\*container 運行
```shell
#run:
#-d 背景執行
#nginx 執行什麼服務
#ng 自訂的tagname
#-name 自訂名稱
# -e 設定環境變數, TZ=Asia/Taipei => 設定時區
docker container run -d nginx
docker container run -d -name ngx nginx
docker container run -d nginx:ng
docker container run -d -e "TZ=Asia/Taipei" nginx
```
\*查看運行container
```shell
docker container ls -a
[tomcat@docker-qc ~]$ docker container ls -a
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
df6ab3df4b14 nginx "nginx -g 'daemon of…" 9 seconds ago Up 8 seconds 80/tcp modest_cray
940d3d804bcd nginx "nginx -g 'daemon of…" 7 minutes ago Up 7 minutes 80/tcp elastic_raman
```
\*運行container 並進入shell
```shell
docker container run -it {container name} sh
```
[](https://bookstack.treemanou.com/uploads/images/gallery/2021-11/XbqLbfiUKtgdFbYz-image-1637142725643.png)
\*進入已運行container
```shell
# 進入名為apache的容器執行sh
docker exec -it apache sh
```
\*複製檔案
```shell
# 建立一個hello.html
echo "hello" > hello.html
# 建立apache
docker run -d --name apache httpd:alpine
# 複製檔案至apache容器中
docker cp hello.html apache:/usr/local/apache2/htdocs/
# 複製容器中的檔案至本機
docker cp apache:/usr/local/apache2/htdocs/index.html ./index.html
```
\*掛載目錄
```shell
# 把hello.html掛成index.html
docker run -d --name apache2 -v $PWD/hello.html:/usr/local/apache2/htdocs/index.html httpd:alpine
```
\*建立外部連線
```shell
# -p port 對應 {本機}:{容器}
docker run -d -v $PWD.hell.html:/url/local/apache2/htdocs/index.html -p 80:80 httpd:alpine
```
---
\*刪除container
[](https://bookstack.treemanou.com/uploads/images/gallery/2021-11/qOCJd5dGCtA5ZwlU-image-1637142432159.png)
```shell
#-f 強制
docker rm -f {container id}
#刪除所有容器
docker rm -f $(docker ps -a -q)
#刪除所有名字有demo的容器
docker rm -f $(docker ps -a -q -f name=demo)
# 停用所有container
docker stop $(docker ps -a -q)
# 刪除沒已使用的container 與 image
docker system prune
# 刪除所有映像檔
docker rmi $(docker images -a -q)
# 刪除所有name = 的映像檔
docker rmi $(docker images -f "dangling=true" -q)
# 刪除所有名稱叫shopcar的映像檔
docker rmi $(docker images shopcar* -q)
# 清除volume
docker volume rm $(docker volume ls)
# 刪除所有沒有使用的container image volume
docker system prune -a -f --volumes
#起一個不會停止的centos
docker run -d --name centos7 centos:7 sleep infinity
```
---
#### 查看要效能
\*從主機查看container process
[](https://bookstack.treemanou.com/uploads/images/gallery/2021-11/VJEXMxCf0qyoGca5-image-1637142044315.png)
[](https://bookstack.treemanou.com/uploads/images/gallery/2021-11/aeI7SiLajqZ2uD20-image-1637142037886.png)
```shell
docker container top {container id}
```
\*查看狀態
```shell
# 容器狀態
docker stats {container id | name }
# cpu ram
docker top {container id | name }
# log
docker logs {container id | name }
docker logs -f {container id | name }
```
---
# Dockerfile 的 /etc/hosts 如何設定
來源：
[Dockerfile 的 /etc/hosts 如何設定 – Tsung's Blog (longwin.com.tw)](https://blog.longwin.com.tw/2018/09/docker-dockerfile-etc-hosts-dns-setup-2018/)
## Dockerfile 的 /etc/hosts 如何設定
於 [Dockerfile reference](https://docs.docker.com/engine/reference/builder/) 文件裡面，沒有看到 /etc/hosts 該怎麼改，後來發現 /etc/hosts 修改的方式還蠻黑暗的~
修改 /etc/hosts 的作法有兩種，先講比較正確的方法：
Docker 增加 hosts 可以參考 Docker run 的文件：[Docker run reference](https://docs.docker.com/engine/reference/run/)
於 Docker run 使用 --add-host=server-name:127.0.0.1，多個用空白隔開，繼續寫下去即可，範例如下：
- **docker run ... --add-host='server:0.0.0.0' ...**
- **docker run ... --add-host='server:127.0.0.1' --add-host='server2:127.0.0.2'...**
若有 /etc/hosts 有太多需要增加，可以使用下述 Shell script 產生 --add-host 參數
- /etc/hosts 若要 1 vs 1 的 ip host 對應
- **cat /etc/hosts | sed 's/^#.\*//g' | grep '\[0-9\]\[0-9\]' | tr "\\t" " " | awk '{print "--add-host="$2":"$1 }' | tr '\\n' ' '**
- /etc/hosts 若要 1 vs n(多) 的 ip host 對應
- **cat /etc/hosts | grep -v "^#" | awk '{for(i=2;i<=NF;i++){print "--add-host "$i":"$1}}'**
再來看比較暴力的作法：(直接寫在 Dockerfile 裡面)
```
# 使用 /tmp/hosts 當 /etc/hosts COPY /etc/hosts /tmp/hosts.bak
RUN cp hosts /tmp/hosts # hosts 於外部 cp /etc/hosts .
#RUN cp /etc/hosts /tmp/hosts #路径长度最好保持一致
RUN mkdir -p -- /lib-override && cp /lib/x86_64-linux-gnu/libnss_files.so.2 /lib-override
RUN sed -i 's:/etc/hosts:/tmp/hosts:g' /lib-override/libnss_files.so.2
ENV LD_LIBRARY_PATH /lib-override
RUN cat /tmp/hosts.bak >> /tmp/hosts
```
Docker 內部讀取 /etc/hosts 的部份，修改成讀取 **/tmp/hosts** (參考自此篇：[Docker 修改 hosts](https://wongxingjun.github.io/2016/04/06/Docker%E4%BF%AE%E6%94%B9hosts/))
將下述寫入 Dockerfile，於 build 的時候，就會讀取 /tmp/hosts 來操作囉~
### 相關網頁
- - [docker 之 dockerFile (解決 hosts，hostname 問題)](https://blog.csdn.net/libo222/article/details/52669093)
- [docker - Modify hosts file in dockerfile](https://serverfault.com/questions/777714/modify-hosts-file-in-dockerfil)
# Docker 使用私有repo (Nexus)
```p1
vim /etc/docker/daemon.json
```
```
{
"insecure-registries": ["10.10.10.10:8083"],
"registry-mirrors": ["http://10.10.10.10:8083"]
}
```
```
sudo systemctl restart docker
```
[](https://bookstack.treemanou.com/uploads/images/gallery/2024-12/Sun0E0r2v3qHI2mq-image-1733823888931.png)
[](https://bookstack.treemanou.com/uploads/images/gallery/2024-12/OeE7TnZi2zpJNQfu-image-1733823909856.png)
https://registry-1.docker.io
[](https://bookstack.treemanou.com/uploads/images/gallery/2024-12/k9GuHCfoM0j1FhJO-image-1733824478204.png)
# Docker 內 container 如何使用Docker
在 Docker 容器內部直接執行宿主機上的 Docker 命令有一定的限制，因為 Docker 容器本身是與宿主機隔離的。以下是一些實現方法，根據不同需求選擇適合的解法：
---
### **方法 1：將 Docker socket 映射到容器**
將宿主機的 Docker socket (`/var/run/docker.sock`) 映射到容器內部，這樣容器內部的 Docker CLI 可以直接與宿主機的 Docker daemon 通訊。
#### **步驟**
1. **啟動容器時掛載 Docker socket：**
```bash
docker run -it --rm \
-v /var/run/docker.sock:/var/run/docker.sock \
-v $(which docker):/usr/bin/docker \
your-image
```
2. **在容器內使用 Docker 命令：** 容器內的 Docker CLI 可以直接操作宿主機的 Docker，執行例如 `docker ps`、`docker run` 等指令。
3. **注意安全性：** 授予容器訪問 Docker socket 的權限會帶來安全風險，因為容器內的進程可以完全控制宿主機的 Docker。僅在信任的環境下使用此方法。
---
### **方法 2：使用 Docker-in-Docker (DinD)**
如果希望在容器內運行獨立的 Docker daemon，可以使用 Docker 官方的 `docker:dind` 映像。
#### **步驟**
1. 啟動 DinD 容器：
```bash
docker run --privileged --name dind-container -d docker:dind
```
2. 進入容器：
```bash
docker exec -it dind-container sh
```
3. 在容器內執行 Docker 命令（這是獨立的 Docker daemon，不會影響宿主機的 Docker）。
---
### **方法 3：使用 Docker CLI 並通過 API 操作**
宿主機的 Docker daemon 提供 REST API，可以在容器內安裝 Docker CLI 並通過 API 操作。
#### **步驟**
1. 確保宿主機的 Docker daemon 開啟遠程 API，編輯 `/etc/docker/daemon.json`：
```json
{
"hosts": ["unix:///var/run/docker.sock", "tcp://0.0.0.0:2375"]
}
```
然後重啟 Docker：
```bash
sudo systemctl restart docker
```
2. 啟動容器，並配置環境變數 `DOCKER_HOST` 指向宿主機 API：
```bash
docker run -it --rm \
-e DOCKER_HOST=tcp://:2375 \
your-image
```
3. 在容器內執行 Docker 命令：
```bash
docker ps
```
---
### **注意事項**
1. **安全風險：**
- 授予容器訪問 Docker socket 或 Docker daemon 的權限可能導致安全漏洞。
- 確保只在受信任的環境中使用，並採取必要的隔離措施（例如：限制網路訪問、使用 TLS 保護 API）。
2. **性能影響：**
- 如果容器內需要頻繁操作宿主機的 Docker，可能會影響宿主機的性能。
3. **權限問題：**
- 確保容器內的進程有足夠的權限訪問 `/var/run/docker.sock` 或 Docker API。
希望這些方法能幫助你解決問題！如果需要更詳細的操作指引，可以告訴我具體的需求或環境設定。
# 【Docker】上傳自己的 Docker image 到 Docker Hub
要上傳自己的 Docker image 到 Docker Hub，請按照以下步驟操作：
### 1. 登入 Docker Hub
確保你的電腦已經安裝了 Docker，然後使用以下命令登入 Docker Hub：
```sh
docker login
```
系統會要求輸入你的 Docker Hub 帳號和密碼。
### 2. 建立 Docker Image
如果你還沒有 Docker image，可以使用 `docker build` 指令來建立：
```sh
docker build -t <你的DockerHub帳號>/: .
```
例如：
```sh
docker build -t myusername/myapp:v1 .
```
這樣就會建立一個 `myusername/myapp` 的 image，標籤（tag）為 `v1`。
### 3. 標記 (Tag) Image
如果你已經有一個本地的 image，但還沒有加上 Docker Hub 的 repository 名稱，你需要先標記它：
```sh
docker tag <本地image ID或名稱> <你的DockerHub帳號>/:
```
例如：
```sh
docker tag myapp:latest myusername/myapp:v1
```
### 4. 推送 (Push) Image
將 image 推送到 Docker Hub：
```sh
docker push <你的DockerHub帳號>/:
```
例如：
```sh
docker push myusername/myapp:v1
```
### 5. 確認上傳成功
你可以到 [Docker Hub](https://hub.docker.com/) 查看你的 repository，或者在其他機器上使用以下命令來拉取（pull）該 image：
```sh
docker pull myusername/myapp:v1
```
### 常見問題
1. **登入失敗**：
- 如果 `docker login` 失敗，可以先在 Docker Hub 上確認你的帳號密碼是否正確。
- 如果你使用的是 Docker Hub 產生的 Access Token，請在密碼欄位輸入該 Token。
2. **推送失敗，沒有權限 (denied: requested access to the resource is denied)**：
- 確保你的 image tag 是 `你的DockerHub帳號/你的image名稱`，而不是本地的名稱。
- 使用 `docker login` 確保你已登入正確的帳號。
這樣你就能成功上傳自己的 Docker image 到 Docker Hub 了！ 🚀
# 【Docker】自動分配網路用盡
failed to create network pub-sub\_pubsub: Error response from daemon: could not find an available, non-overlapping IPv4 address pool among the defaults to assign to the network
👉 **這個錯誤的意思是**：
> Docker **沒有可用的 IP 網段** 來建立新的 network。
Docker 每次起新的 network，會自動從預設的 IP range (例如 172.18.0.0/16) 分配一段子網（subnet）來給你的 `docker-compose`。
但因為你本機已經有太多 Docker network（或之前的 container network 沒清乾淨），導致 **IP address range 已經用光了**。
解法，詳細往下看
```YAML
# 查詢目前所有container網段
docker network inspect $(docker network ls -q) --format '{{.Name}}: {{(index .IPAM.Config 0).Subnet}}'
# 刪除無用network
docker network prune
#解法，指定網段
networks:
ngtest:
driver: bridge
ipam:
config:
- subnet: 172.20.0.0/24
```
---
# 🛠️ 解法 1：刪掉無用的 Docker Network
先看一下目前的 network：
```bash
docker network ls
```
會看到一堆像這樣：
NETWORK ID NAME DRIVER SCOPE 1a2b3c4d5e bridge bridge local 6f7g8h9i0j pub-sub\_pubsub bridge local ... ... ... ...
然後手動刪掉沒用的 network，例如：
```bash
docker network rm network_name
```
例如：
```bash
docker network rm pub-sub_pubsub
```
要一口氣刪很多：
```bash
docker network prune
```
（⚡小心！`prune` 會**把所有未使用的網路刪掉**。）
---
# 🛠️ 解法 2：docker-compose.yml 手動指定 IP 範圍
如果你想避免這個問題，以後可以**自己在 `docker-compose.yml` 裡面設定固定的子網段**，例如：
```yaml
networks:
pubsub-net:
driver: bridge
ipam:
config:
- subnet: 172.30.0.0/16
```
然後每個 service 指定 network：
```yaml
services:
pubsub-emulator:
image: google/cloud-sdk:latest
networks:
- pubsub-net
```
這樣 Docker 就不會自己亂分配 IP，會用你指定的 `172.30.0.0/16`，可以大大降低出錯的機會。
---
# 🔥 最快速推薦操作
直接下這兩行，清除掉無用網路 ➔ 再重開 docker-compose：
```bash
docker network prune -f
docker-compose up
```
---
# 🛎️ 小提醒
問題情境 說明 通常出現在 Docker Desktop 很久沒清 每次起 network，Docker 自動分配，結果越堆越多 `docker network ls` 看太多 bridge 可以確認哪些是 zombie network `docker-compose down` 不一定會清 network 要自己下 `prune` 或 `network rm`
---
好問題！
你問的這個其實就是：
> **如何查目前 Docker 所有 network 的網段（subnet），確保自己新建的網段不會衝突？**
這個是專業級的 docker networking 操作了，我來直接教你最正確、完整又快速的方法 👨🏻💻
---
# ✅ 查詢目前所有 Docker network 網段的方法
直接打：
```bash
docker network inspect $(docker network ls -q) --format '{{.Name}}: {{(index .IPAM.Config 0).Subnet}}'
```
這條指令的意思是：
- `docker network ls -q`：列出所有 network 的 ID
- `docker network inspect`：逐個去查 network 詳細資訊
- `--format`：只輸出你要看的部分（名字 + 子網範圍）
👉 出來結果像這樣：
```
bridge: 172.17.0.0/16
host:
none:
myproject_default: 172.21.0.0/16
another-network: 172.22.0.0/16
```
如果某些 network 是空的（像 `host`、`none`），那是正常的，因為它們沒有自己管理 IP。
---
# 🛠️ 查完之後怎麼重新分配？
- 看到目前用掉哪些子網了（例如 172.17.0.0/16、172.21.0.0/16）
- 選一個**完全沒重疊**的新網段來建你的 network，例如：
- `172.28.0.0/24`
- `172.30.0.0/24`
- `192.168.100.0/24`
- `10.20.0.0/24`
- 然後在你的 `docker-compose.yml` 裡設定你自己的網段！
（一般建議用 172.x.x.x / 192.168.x.x / 10.x.x.x 這些 private 網段）
---
# 🔥 進階版（更詳細看）
如果你想要看得更細，例如看到每個 container 的 IP，可以打：
```bash
docker network inspect network-name
```
例：
```bash
docker network inspect bridge
docker network inspect pubsub-net
```
它會印出一個超大 JSON，裡面會列出：
- 網段 subnet
- gateway
- 已連接的 container 名稱和 IP 地址
---
# 🛎️ 小結論
你想做什麼 指令 看所有 network 網段 `docker network inspect $(docker network ls -q) --format '{{.Name}}: {{(index .IPAM.Config 0).Subnet}}'` 詳細看某個 network `docker network inspect network-name`
---
# 【Docker】image tage 比較
當然可以！我們來一一比較你提到的這些 Docker image tag（以 Node.js 為例常見的 tag 形式），重點在於：
> ❗**它們的差異主要在底層作業系統的發行版與體積，會影響相容性、功能完整度、啟動速度與安全更新週期。**
---
## ✅ 比較總覽表
Tag 底層系統 體積（概估） 相容性 套件完整度 適合場景 `20.19.3` Debian（預設） 🟠 中（~100MB） ✅ 高 ✅ 完整 開發 / 安全穩定部署 `20.19.3-slim` Debian（精簡） 🟡 較小（~30–50MB） ✅ 高 🟡 精簡套件 精簡部署，但仍需套件支援 `20.19.3-bullseye` Debian 11 (Bullseye) 🟠 中 ✅ 高 ✅ 完整 LTS 開發與部署 `20.19.3-bullseye-slim` Debian 11 (精簡) 🟡 較小 ✅ 高 🟡 精簡 比 `slim` 更指定版本的精簡版 `20.19.3-bookworm` Debian 12 (Bookworm) 🟠 中 ✅ 高 ✅ 完整 新版 Debian，未來趨勢 `20.19.3-bookworm-slim` Debian 12 (精簡) 🟡 較小 ✅ 高 🟡 精簡 更「新」的精簡版本 `20.19.3-alpine3.22` Alpine Linux 3.22 🟢 超小（~5MB） ⚠️ 中 ❌ 非常精簡 超小部署映像，需自行加套件 `20.19.3-alpine` 最新 Alpine 版本 🟢 超小 ⚠️ 中 ❌ 非常精簡 最新 alpine，可能有相容性風險
---
## 🧩 詳細說明與比較依據
### 1️⃣ **無尾碼版本：`20.19.3`**
- 預設會用 **Debian（目前是 Bookworm 或 Bullseye）**
- 最穩定、最多人支援的標準版本
- 套件支援完整，但 image 比 slim 大
---
### 2️⃣ **slim 系列（`slim`, `bullseye-slim`, `bookworm-slim`）**
- 相比完整版，移除了 **man pages、locale 資料、編譯工具**
- 仍然保留 Debian 的核心相容性
- 較小但仍易於除錯與擴充，比 alpine 安全穩
---
### 3️⃣ **alpine 系列（`alpine`, `alpine3.22`）**
- 超小型（~5MB），非常適合部署
- 缺點：需額外安裝 libc（有時需 glibc，不然會出現 `segmentation fault`）
- 有些 Node 原生模組會無法正常編譯
- 建議只在熟悉 Alpine Linux 的情況下使用
---
### 4️⃣ **bullseye vs. bookworm**
- `bullseye` = Debian 11（2021 發布）
- `bookworm` = Debian 12（2023 發布，目前最新版）
> 若你要做長期部署，**bookworm 更新、更長期支援**；但部分舊系統（如 AWS AMI、某些 lib）可能還用 bullseye。
---
## ✅ 實務建議
需求 建議使用 要最穩、開發與部署兼顧 `20.19.3` 或 `20.19.3-bookworm` 部署在 Docker，但想減少容量 `20.19.3-slim` 或 `20.19.3-bookworm-slim` 專案熟悉 Alpine、對大小敏感 `20.19.3-alpine`（但需額外測試） 你想明確指定環境版本以便重建一致性 `20.19.3-bullseye` / `bookworm` / `alpine3.22` 等有版本號的更佳
---
## 📌 附加提醒
- 有些 Node 原生模組（如 `bcrypt`, `sharp`, `canvas`）在 `alpine` 上常常會遇到編譯問題。
- `slim` 不代表最小，只是比完整版小；真正小的是 `alpine`。
- 不同 tag 最安全的選法是「**明確指定版本與 base image**」，可確保可重現性。
---
# ELK
# ElasticSearch 啟動
### Starting Elasticsearch
[Starting Elasticsearch | Elasticsearch Guide \[7.14\] | Elastic](https://www.elastic.co/guide/en/elasticsearch/reference/current/starting-elasticsearch.html)
# Elasticsearch REST Api
[喬叔的 Elasticsearch 基礎實務班 (2021.07.24~25) - HackMD](https://hackmd.io/YZNLmE4ZRs28v5XX5lplDg)
[](http://bookstack.treemanou.com/uploads/images/gallery/2021-09/CxAtmrHBPXONsorz-image-1631848723417.png)
[](http://bookstack.treemanou.com/uploads/images/gallery/2021-09/Heg90G0f3b0Pff09-image-1631848837295.png)
Index與type欄位是必要的,id若省去,Elasticsearch
會為document加上自動產生的id。
– 自動產生的id為22字元長、URL-safe、Base64-encoded
string UUID。
- 若給予的index或type名稱目前並不存在時
,Elasticsearch會以預設設定值自動建立該名稱的
index或type。
- 若不給予id時,index資料應使用POST。
- type 建議使用 \_doc (since 6.0)
# 【Elasticsearch】容量100%
```shell
# 替換 和 為實際的 Elasticsearch 主機和索引名稱模式
# 列出所有索引
curl -X GET "http://:9200/_cat/indices?v"
# 删除特定模式的索引（例如，以 "log-" 开头的索引）
curl -X DELETE "http://:9200/"
# 删除所有索引（請謹慎使用）
# curl -X DELETE "http://:9200/*"
```
# Elasticsearch search
關於搜尋
[Elastic Stack第七重 - iT 邦幫忙::一起幫忙解決難題，拯救 IT 人的一天 (ithome.com.tw)](https://ithelp.ithome.com.tw/articles/10236812)
# 【Filebeat】Mac 安裝
mac 安裝
https://www.elastic.co/guide/en/beats/filebeat/8.7/filebeat-installation-configuration.html#installation
```
brew install filebeat
```
```
zsh completions have been installed to:
/usr/local/share/zsh/site-functions
To restart filebeat after an upgrade:
brew services restart filebeat
Or, if you don't want/need a background service you can just run:
/usr/local/opt/filebeat/bin/filebeat
```
# 【Filebeat】相關連結
- [【轉】使用 Filebeat 應該要了解的設計細節與原理](https://training.onedoggo.com/tech-sharing/uncle-joe-teach-es-elastc-observability/logs-wa-jue-xi-tong-nei-bu-fa-sheng-de-zhuang-kuang/shi-yong-filebeat-ying-gai-yao-le-jie-de-she-ji-xi-jie-yu-yuan-li)
- [官方文件 - Filebeat Inputs ](https://www.elastic.co/guide/en/beats/filebeat/7.15/configuration-filebeat-options.html)
- [喬叔帶你上手 Elastic Stack - 探索與實踐 Observability 系列](https://training.onedoggo.com/tech-sharing/uncle-joe-teach-es-elastc-observability)
# Elasticsearch 查詢語法
query
```
查询一级标签
query
二级标签
prefix wildcard
constant_score
filter
prefix 前缀匹配,文档中的词语以搜索的词汇开头
{field:value}
term
代表完全匹配,即不进行分词器分析,文档中必须包含整个搜索的词汇
{field:value}
match
match和term的区别是,match查询的时候,elasticsearch会根据你给定的字段提供合适的分析器,而term查询不会有分析器分析的过程
match查询相当于模糊匹配,只包含其中一部分关键词就行
{field:value}
match_all 没有参数,查询出来所有
{}
match_phrase 匹配一个短语,给一个短语词,匹配
{field:value}
multi_match 匹配多个字段
{
"query": {
"multi_match": {
"query": "caoke2",
"fields": [
"msg",
"code"
]
}
}
}
range
{"age":{"lt":10,"gt":1}}
-- 以上两级关键字 不能同时使用 多关键字需要用bool
bool 布尔查询,匹配多个条件,下面的关键字中可以把上面的再嵌套一遍 bool中不能包含range,要用filter包裹
must should must_not filter
多个查询条件用数组包裹
highlight 自定义标签的前后缀,fields 里面的字段要是query中查询的字段
"highlight":{
"pre_tags":[
""
],
"post_tags":[
" "
],
"require_field_match":true,
"fields":{
"msg":{
"fragment_size":1000,
"number_of_fragments":0,
"fragment_offset":0
}
}
}
from 查询的结果取范围开始
size 查询的结果取范围结束
sort 排序
"sort": [
{
"age": "desc"
}
]
_source 包含or排除字段
{"includes":["code"],"excludes":[]}
script_fields
aggs 聚合
"aggregations":{
"term_agg":{
"terms":{
"field":"age", 对字段分组
"size":10, 返回的条数
"order":[{ 对返回的结果排序，可以多条
"min_agg":"desc"
}]
},
"aggregations":{ 分组后需要统计，可以多个
"min_agg":{
"min":{
"field":"age"
}
}
}
}
}
```
# 【Kibana】 使用 https
要在本機環境的 Kibana 自產憑證，並讓 Kibana 支援 **HTTPS**，而非預設的 **HTTP**，以下是詳細步驟：
---
## 🚀 **步驟 1：產生自簽名憑證（Self-Signed Certificate）**
### 🔧 **使用 OpenSSL 產生憑證：**
1. **開啟終端機**，執行以下指令來建立一個新的私鑰和自簽名憑證：
```bash
mkdir -p /etc/kibana/ssl
cd /etc/kibana/ssl
# 產生私鑰和自簽名憑證，設定有效期限為 365 天
openssl req -x509 -newkey rsa:4096 -keyout kibana-key.pem -out kibana-cert.pem -days 365 -nodes
# 修改擁有者，權限
chown kibana:kibana kibana-key.pem
chown kibana:kibana kibana-cert.pem
chmod 644 kibana-key.pem
chmod 600 kibana-key.pem
```
### 💡 **輸入相關資訊：**
在執行上述指令時，OpenSSL 會要求輸入一些資訊，像是：
- **Country Name (國家代碼)**：TW
- **State or Province Name (省/市)**：Taipei
- **Locality Name (城市)**：Taipei
- **Organization Name (公司名稱)**：momo.com
- **Common Name (CN)**：apielkmonitor.momoshop.com.tw
Country Name (2 letter code) \[AU\]:TW
State or Province Name (full name) \[Some-State\]:Taipei
Locality Name (eg, city) \[\]:Taipei
Organization Name (eg, company) \[Internet Widgits Pty Ltd\]:momo.com
Organizational Unit Name (eg, section) \[\]:
Common Name (e.g. server FQDN or YOUR name) \[\]:apielkmonitor.momoshop.com.tw
Email Address \[\]:srou@fmt.com.tw
### 🎯 **產生的檔案：**
- kibana-cert.pe：私鑰
- kibana-cert.pe：自簽名憑證
---
## 🚀 **步驟 2：配置 Kibana 使用 HTTPS**
### 🔧 **編輯 Kibana 的設定檔 `kibana.yml`：**
打開 **`kibana.yml`** 檔案（通常位於 `/etc/kibana/kibana.yml` 或你的安裝目錄下），修改以下內容：
```yaml
# 啟用 SSL
server.ssl.enabled: true
# 設定 SSL 憑證和私鑰的路徑
server.ssl.certificate: /etc/kibana/ssl/kibana-crt.pem
server.ssl.key: /etc/kibana/ssl/kibana-key.pem
# 修改 Kibana 的監聽端口
server.port: 443
# 如果elasticsearch 使用ssl 連線(沒有則不用)
# 選擇驗證證書的方式
elasticsearch.ssl.verificationMode: full
# 這個證書在 Elasticsearch 的 HTTP 證書時已經生成。複製到 Kibana 安裝目錄下配置使用即可。
elasticsearch.ssl.certificateAuthorities: [ "/data/kibana-8.13.0/elasticsearch-ca.pem" ]
```
> ⚠️ **注意**：將 `/path/to/` 替換成你實際的憑證路徑。
---
## 🚀 **步驟 3：允許本機信任自簽名憑證**
### 🖥️ **Mac 或 Linux：**
將自簽名憑證 **kibana.crt** 匯入你的系統信任區：
```bash
sudo cp kibana.crt /usr/local/share/ca-certificates/kibana.crt
sudo update-ca-certificates
```
### 🖥️ **Windows：**
1. 打開 **證書管理**。
2. 選擇 **受信任的根憑證授權單位**。
3. 匯入 **kibana.crt** 檔案。
---
## 🚀 **步驟 4：重啟 Kibana**
```bash
sudo systemctl restart kibana
```
---
## 🎯 **步驟 5：透過 HTTPS 訪問 Kibana**
現在，你可以使用 **`https://localhost`**（或指定的 IP 地址）來訪問 Kibana。
---
### 錯誤處理:
#### **FATAL Error: listen EACCES: permission denied 0.0.0.0:443**
1. ```shell
# 啟動服務錯誤
sudo systemctl start kibana
# 可以使用以下語法查看詳細錯誤
journalctl -u kibana -f
#如果出現以下錯誤，代表不允許非root人員啟用1024 port 以下服務
FATAL Error: listen EACCES: permission denied 0.0.0.0:443
#使用以下語法同意以下檔案綁定使用1024 port 以下服務
setcap cap_net_bind_service=+epi /usr/share/kibana/bin/kibana
setcap cap_net_bind_service=+epi /usr/share/kibana/bin/kibana-plugin
setcap cap_net_bind_service=+epi /usr/share/kibana/bin/kibana-keystore
# node以實際位置為主
setcap cap_net_bind_service=+epi /usr/share/kibana/node/glibc-217/bin/node
```
#### **Error: EACCES: permission denied, open '/run/kibana/kibana.pid'**
```
chown kibana:kibana /run/kibana/kibana.pid
setcap cap_net_bind_service=+epi /run/kibana/kibana.pid
```
# 【 錯誤處理】watermark 設定太小導致index 變成唯讀
##### Log 出現:
##### filebeat-7.1 7.7-app-integrity-ap-prod-2025.11.09\] blocked by: \[TOO\_MANY\_REQUESTS/12/disk usage exceeded flood-st age watermark, index has read-only-allow-delete block\];
---
以下是 **Elasticsearch 出現 flood-stage watermark**（磁碟使用率過高）導致 index 變成 **read-only-allow-delete** 的完整處理方式（你目前的錯誤訊息就是這個觸發的）。
---
# ✅ 錯誤原因
你的 Filebeat / Logstash 嘗試寫入索引
`filebeat-7.7-app-integrity-ap-prod-2025.11.09`
但 Elasticsearch 回覆：
```
blocked by: [TOO_MANY_REQUESTS/12/disk usage exceeded flood-stage watermark, index has read-only-allow-delete block]
```
這代表：
1. **磁碟使用量超過 ES flood-stage watermark（預設 95%）**
2. ES 自己把 index 設成 **唯讀（read-only-allow-delete）**
3. 所有寫入都會 429 / 403
ES 為了保護資料，所以禁止寫入。
---
# ✅ 解決方式
## Step 1：檢查磁碟使用率
```bash
df -h
```
如果你看到 `/var/lib/elasticsearch` 所在的分區超過 95%，你要先：
- 清舊 index
- 增加磁碟空間
- 或移動 data path
---
# Step 2：刪除舊 index（最常見處理方式）
例如刪除 90 天前的索引：
```bash
curl -X DELETE "http://localhost:9200/filebeat-*-2025.08.*"
```
或手動刪除：
```bash
curl -X DELETE "http://localhost:9200/filebeat-7.7-momo-app-integrity-ap-prod-2025.11.09"
```
💡你可以先查看所有索引大小：
```bash
curl -X GET "http://localhost:9200/_cat/indices?v&h=index,store.size"
```
---
# Step 3：解除 ES 的 read-only 保護
即使磁碟清乾淨了，ES 還是會記住 read-only block
**要自己取消**
對所有 index：
```bash
curl -X PUT "http://localhost:9200/_all/_settings" -H 'Content-Type: application/json' -d'
{
"index.blocks.read_only_allow_delete": null
}
'
```
或指定某個 index：
```bash
curl -X PUT "http://localhost:9200/filebeat-7.7-momo-app-integrity-ap-prod-2025.11.09/_settings" \
-H 'Content-Type: application/json' -d'
{
"index.blocks.read_only_allow_delete": null
}
'
```
---
# Step 4（建議）：調整 ES Watermark 避免一直被鎖
例如：
```bash
curl -X PUT "http://localhost:9200/_cluster/settings" \
-H 'Content-Type: application/json' -d'
{
"persistent": {
"cluster.routing.allocation.disk.watermark.low": "80%",
"cluster.routing.allocation.disk.watermark.high": "90%",
"cluster.routing.allocation.disk.watermark.flood_stage": "95%",
"cluster.info.update.interval": "1m"
}
}
'
```
---
# Step 5（可選）：手動清理 translog
如果 ES 卡住很久，也可以清理 translog：
```bash
curl -X POST "localhost:9200/filebeat-*/_flush"
```
---
# 🔍 最快解法（給你直接用）
1. **刪舊 index**
2. **解除 read-only**
```bash
curl -X PUT "http://localhost:9200/_all/_settings" \
-H 'Content-Type: application/json' -d'
{
"index.blocks.read_only_allow_delete": null
}
'
```
3. **恢復 Filebeat 寫入**
---
# ✅ 什麼是 Watermark？
Elasticsearch 預設會監控 data 目錄所在磁碟使用率：
Name 意義 預設值 行為 **low watermark** 開始重新 routing shard 85% 輕警告 **high watermark** 停止將新 shard 分配到該節點 90% 停止新增 shard **flood-stage watermark** **把 index 改成唯讀** **95%** 造成 `read-only-allow-delete`
你的錯誤訊息就是因為 flood-stage 達標。
---
# ✅ 修改 Watermark（官方標準方式）
### 👉 調整 Watermark 百分比
以下 API 會直接套用在整個 cluster：
```bash
curl -X PUT "http://localhost:9200/_cluster/settings" \
-H 'Content-Type: application/json' -d'
{
"persistent": {
"cluster.routing.allocation.disk.watermark.low": "80%",
"cluster.routing.allocation.disk.watermark.high": "90%",
"cluster.routing.allocation.disk.watermark.flood_stage": "95%",
"cluster.info.update.interval": "1m"
}
}
'
```
### 三個參數的用途：
- `"low": "80%"`
80% 才開始觸發 routing
- `"high": "90%"`
90% 以上 ES 不會在該 node 分配新的 shard
- `"flood_stage": "95%"`
超過 95% ES 會鎖 index → read-only
---
# ✅ 調整成更寬鬆（如果磁碟常滿）建議這組：
你可以把 flood\_stage 往上調，比如 98% 或 99%：
```bash
curl -X PUT "http://localhost:9200/_cluster/settings" \
-H 'Content-Type: application/json' -d'
{
"persistent": {
"cluster.routing.allocation.disk.watermark.low": "85%",
"cluster.routing.allocation.disk.watermark.high": "92%",
"cluster.routing.allocation.disk.watermark.flood_stage": "98%",
"cluster.info.update.interval": "30s"
}
}
'
```
💡 **若是單機環境（非 cluster），98% 是最常見的設定。**
---
# ⚠️ 另一種方式：改用「磁碟剩餘容量 (free bytes)」而不是百分比
例如磁碟剩下 10GB 才鎖 index：
```bash
curl -X PUT "http://localhost:9200/_cluster/settings" \
-H 'Content-Type: application/json' -d'
{
"persistent": {
"cluster.routing.allocation.disk.watermark.low": "10gb",
"cluster.routing.allocation.disk.watermark.high": "5gb",
"cluster.routing.allocation.disk.watermark.flood_stage": "2gb"
}
}
'
```
這種方式比較直覺、不怕磁碟變大或變小。
---
# 🚨 注意：調整 Watermark 不會解除 index 的 read-only
如果某些 index 已經被鎖，需要再解除：
```bash
curl -X PUT "http://localhost:9200/_all/_settings" \
-H 'Content-Type: application/json' -d'
{
"index.blocks.read_only_allow_delete": null
}
'
```
或指定某個 index：
```bash
curl -X PUT "http://localhost:9200/filebeat-*/_settings" \
-H 'Content-Type: application/json' -d'
{
"index.blocks.read_only_allow_delete": null
}
'
```
---
查看所有 index 大小：
```
curl -X GET "http://localhost:9200/_cat/indices?v&h=index,store.size"
```
# 【參數說明】enable_for_single_data_node
下面我會用 **最清楚、最貼近你現在 ES 架構的方式** 解釋
`enable_for_single_data_node` 是什麼、什麼時候要開/關、會影響什麼。
---
# ⭐ **1. enable\_for\_single\_data\_node 是什麼？**
這是一個 **Elasticsearch 控制 Watermark 是否要啟用於單節點（Single Data Node）環境的設定**。
完整參數名稱：
```
cluster.routing.allocation.disk.watermark.enable_for_single_data_node
```
它的作用：
> **如果你的 Elasticsearch 只有 1 台 node（單機 ES），是否也要套用磁碟 watermark 限制？**
---
# ⭐ **2. 為什麼會有這個設定？**
因為 Elasticsearch 原本的 watermark 行為（low / high / flood\_stage）是為 **多節點 cluster** 設計的。
但如果你是：
✔ 單機 Elasticsearch
✔ 沒有第二台 node 可以搬 shard
那就會出現很尷尬的情況：
> 一旦磁碟超過 watermark（例如 high 90%）
> ES 想搬 shard……
> 但根本沒有其他 node 能搬
> 然後 ES 就會把 shard 標成 UNASSIGNED
> 或直接鎖住 index（Read-only）
這在單機 ES 是「不合理且災難級別的行為」。
所以 ES 才加入這個參數：
---
# ⭐ **3. 功能用一句話總結**
### 👉 如果設定成 `true`
即使你只有 1 台 Elasticsearch，也會啟用 watermark（high / flood\_stage 等）。
### 👉 如果設定成 `false`
單機 ES **忽略 high watermark（不阻止分配 shard）**
但 **flood\_stage（95%）還是會強制生效**（避免你把磁碟寫爆）
---
# ⭐ **4. 預設值是？（重點）**
版本差異：
Elasticsearch 版本 預設值 說明 **7.x** `false` 單機不啟用 high watermark **8.x** `true` 單機也啟用完整 watermark 機制
如果你看到是 `true`，通常代表：
✔ 你是 ES 8.x
✔ 或你用了 hot/warm/cold/frozen 層級
✔ 或你用到 searchable snapshots
---
# ⭐ **5. 那你應該設 true 還是 false？（最重要）**
### ✔ 如果你是 **單機 Elasticsearch（只有 1 台）**
我建議：
```
cluster.routing.allocation.disk.watermark.enable_for_single_data_node": false
```
理由：
- 避免 high watermark（90%）直接禁止 shard 分配
- 避免 index 提前 read-only
- 避免 cluster 假性「red/yellow」狀態
- 單機沒必要用 cluster-style routing
> 但 flood\_stage 仍然會保護你避免磁碟爆滿。
這是 **單機 ES 正常、合理、安全** 的設定。
---
### ✔ 如果你是 **真正的多節點 cluster（>= 2 data node）**
你應該保留 `true`
讓 ES 正常做 shard relocation。
---
# ⭐ **6. 單行解釋（你可以放到備忘）：**
##### `enable_for_single_data_node = false` → 單機不要限制太多，不要亂搬 shard
##### `enable_for_single_data_node = true` → 多機需要完整 watermark 保護
---
# ⭐ 7. 你現在的情況（結論）
根據你前面截圖：
你有 frozen、watermark、read-only、filebeat 等狀況
**高度機率你是單機 or 少數機器的 ES**
所以：
```
"cluster.routing.allocation.disk.watermark.enable_for_single_data_node": "true"
```
會讓 ES：
❌ 必須搬 shard
❌ 但沒地方搬
❌ 於是高水位直接阻斷分配
❌ 然後 ES 把 index 鎖成 read-only
❌ 造成 filebeat 錯誤
你就會看到「設定無效」、「read-only-allow-delete」、「flood-stage」等問題。
---
# ⭐ 給你正確的單機 ES 設定模板（最穩定、不會鎖 index）
```bash
PUT _cluster/settings
{
"persistent": {
"cluster.routing.allocation.disk.watermark.low": "10gb",
"cluster.routing.allocation.disk.watermark.high": "5gb",
"cluster.routing.allocation.disk.watermark.flood_stage": "2gb",
"cluster.routing.allocation.disk.watermark.enable_for_single_data_node": "false",
"cluster.routing.allocation.disk.watermark.low.frozen": null,
"cluster.routing.allocation.disk.watermark.high.frozen": null,
"cluster.routing.allocation.disk.watermark.flood_stage.frozen": null,
"cluster.routing.allocation.disk.watermark.low.frozen.max_headroom": null,
"cluster.routing.allocation.disk.watermark.high.frozen.max_headroom": null,
"cluster.routing.allocation.disk.watermark.flood_stage.frozen.max_headroom": null
}
}
```
---
# 如果你願意
貼下面這段，我可以直接判斷你該用 `true` 或 `false`：
```
GET _cat/nodes?v
```
或
```
GET _cluster/settings?include_defaults=true&pretty
```
我可以直接比對你的 cluster 架構（單機/多機）給你最適設定。
# 【常用指令】kibana Dev Tools
[](https://bookstack.treemanou.com/uploads/images/gallery/2025-11/Q1Zup5B1aSXjN3Ph-image-1762845727389.png)
```shell
# 查看設定
GET /_cluster/settings?include_defaults=true&pretty
```
# Go
# Day 1
go package manager
```
go mod init go_demo
```
func 首字大寫 public
func 首字小寫 private
# Grafana & Prometheus
# Grafana_install
[https://fanatical-dentist-b1d.notion.site/Grafana-b93a5178e6a64bad886b83fd6bdcf4ea](https://fanatical-dentist-b1d.notion.site/Grafana-b93a5178e6a64bad886b83fd6bdcf4ea)
Enterprise
```INI
[grafana]
name=grafana
baseurl=https://packages.grafana.com/enterprise/rpm
repo_gpgcheck=1
enabled=1
gpgcheck=1
gpgkey=https://packages.grafana.com/gpg.key
sslverify=1
sslcacert=/etc/pki/tls/certs/ca-bundle.crt
```
OSS
```INI
[grafana]
name=grafana
baseurl=https://packages.grafana.com/oss/rpm
repo_gpgcheck=1
enabled=1
gpgcheck=1
gpgkey=https://packages.grafana.com/gpg.key
sslverify=1
sslcacert=/etc/pki/tls/certs/ca-bundle.crt
```
install
```shell
sudo yum install grafana
# install zabbix plugin
grafana-cli plugins install alexanderzobnin-zabbix-app
```
# Actuator+Prometheus+Grafana監控視覺化簡介
[https://www.tpisoftware.com/tpu/articleDetails/2446](https://www.tpisoftware.com/tpu/articleDetails/2446)
pom.xml 需增加以下依賴：
```XML
org.springframework.boot
spring-boot-starter-actuator
io.micrometer
micrometer-registry-prometheus
```
```INI
#management.endpoint.health.show-details=ALWAYS
#management.endpoints.web.base-path=/monitor
management.endpoints.web.exposure.include=prometheus,metrics
```
- Prometheus 快速入门教程（六）：Spring Boot Actuator 实现应用监控
[https://www.cnblogs.com/chanshuyi/p/06\_prometheus\_with\_springboot\_actuator.html](https://www.cnblogs.com/chanshuyi/p/06_prometheus_with_springboot_actuator.html)
- Spring Boot 微服務應用整合Prometheus + Grafana 實現監控告警
[https://juejin.cn/post/6844904052417904653](https://juejin.cn/post/6844904052417904653)
- spring-prometheus的指標意義
[https://blog.csdn.net/ssehs/article/details/123961221](https://blog.csdn.net/ssehs/article/details/123961221)
- prometheus 使用netdata 資料
[https://learn.netdata.cloud/docs/exporting-metrics/prometheus#configure-prometheus-to-scrape-netdata-metrics](https://learn.netdata.cloud/docs/exporting-metrics/prometheus#configure-prometheus-to-scrape-netdata-metrics)
# Grafana alerting
https://www.cnblogs.com/liugp/p/17003484.html
# Grafana 下拉選單(prometheus)
[](https://bookstack.treemanou.com/uploads/images/gallery/2024-02/3ai42qyKTzETIpE3-image-1709185419013.png)
prometheus
[](https://bookstack.treemanou.com/uploads/images/gallery/2024-02/M97jqpmykl8A84mR-image-1709185498384.png)
prometheus 設定檔，新增自訂label
[](https://bookstack.treemanou.com/uploads/images/gallery/2024-02/VNvJW7urVXNHKC10-image-1709185606695.png)
# Prometheus 相關資源
- [官方範例設定檔](https://github.com/prometheus/prometheus/blob/release-2.50/config/testdata/conf.good.yml)
- [prometheus-book](https://yunlzheng.gitbook.io/prometheus-book/parti-prometheus-ji-chu/alert)
- [prometheus實戰](https://songjiayang.gitbooks.io/prometheus/content/)
# Prometheus PromQL
[](https://bookstack.treemanou.com/uploads/images/gallery/2024-03/iCarZJaclwkXMPXT-image-1710164090550.png)
[](https://bookstack.treemanou.com/uploads/images/gallery/2024-03/Ga8vgsEYE3ymwYsm-image-1710164264802.png)
[](https://bookstack.treemanou.com/uploads/images/gallery/2024-03/Qpjr6qPv2hchWi5f-image-1710164314644.png)
[](https://bookstack.treemanou.com/uploads/images/gallery/2024-03/7XXg6uSgUzGsYk7O-image-1710164366437.png)
[](https://bookstack.treemanou.com/uploads/images/gallery/2024-03/1Swc4xYQPi2GGlBn-image-1710164466436.png)
[](https://bookstack.treemanou.com/uploads/images/gallery/2024-03/mDjlyAKYXHqsw5Pb-image-1710164634100.png)
[](https://bookstack.treemanou.com/uploads/images/gallery/2024-03/f70CxPHHnKTCYCC6-image-1710164902975.png)
[](https://bookstack.treemanou.com/uploads/images/gallery/2024-03/wYe5BlPGUVQpqS6j-image-1710165243618.png)
# Grafana_Promethues docker-compose
```YAML
version: '3.3'
volumes:
prometheus_data: {}
grafana_data: {}
networks:
monitoring:
driver: bridge
services:
prometheus:
image: prom/prometheus
container_name: prometheus
restart: always
volumes:
- /etc/localtime:/etc/localtime:ro
- ./prometheus/:/etc/prometheus/
- prometheus_data:/prometheus
command:
- '--config.file=/etc/prometheus/prometheus.yml'
- '--storage.tsdb.path=/prometheus'
- '--web.console.libraries=/usr/share/prometheus/console_libraries'
- '--web.console.templates=/usr/share/prometheus/consoles'
networks:
- monitoring
# links:
# - alertmanager
# - node_exporter
expose:
- '9090'
ports:
- 9090:9090
# alertmanager:
# image: prom/alertmanager
# container_name: alertmanager
# restart: always
# volumes:
# - /etc/localtime:/etc/localtime:ro
# - ./alertmanager/:/etc/alertmanager/
# command:
# - '--config.file=/etc/alertmanager/config.yml'
# - '--storage.path=/alertmanager'
# networks:
# - monitoring
# expose:
# - '9093'
# ports:
# - 9099:9093
# node_exporter 為了能夠采集到主機的運行指標如CPU, 內存，磁盤
# node_exporter:
# image: prom/node-exporter:v0.18.0
# container_name: node_exporter
# restart: always
# volumes:
# - /etc/localtime:/etc/localtime:ro
# - /proc:/host/proc:ro
# - /sys:/host/sys:ro
# - /:/rootfs:ro
# command:
# - '--path.procfs=/host/proc'
# - '--path.sysfs=/host/sys'
# - --collector.filesystem.ignored-mount-points
# - "^/(sys|proc|dev|host|etc|rootfs/var/lib/docker/containers|rootfs/var/lib/docker/overlay2|rootfs/run/docker/netns|rootfs/var/lib/docker/aufs)($$|/)"
# networks:
# - monitoring
# expose:
# - '9100'
grafana:
image: grafana/grafana
user: "472"
container_name: grafana
restart: always
environment:
GF_SECURITY_ADMIN_PASSWORD: admin
volumes:
- /etc/localtime:/etc/localtime:ro
- ./grafana/grafana_data:/var/lib/grafana
- ./grafana/provisioning/:/etc/grafana/provisioning/
# env_file:
# - ./grafana/config.monitoring
networks:
- monitoring
links:
- prometheus
ports:
- 3000:3000
depends_on:
- prometheus
```
```YAML
version: "3.7"
services:
db:
image: postgres:13.2-alpine
restart: always
environment:
POSTGRES_DB: postgres
POSTGRES_USER: postgres #postgres
POSTGRES_PASSWORD: 12345678 #1234
PGDATA: /var/lib/postgresql/data
volumes:
- ./data/db:/var/lib/postgresql/data
ports:
- "5432:5432"
# pgadmin:
# image: dpage/pgadmin4:latest
# restart: always
# environment:
# PGADMIN_DEFAULT_EMAIL: admin@fmt.com.tw #xxx@gmail
# PGADMIN_DEFAULT_PASSWORD: 12345678 #abcd
# PGADMIN_LISTEN_PORT: 80
# ports:
# - "5433:80"
# volumes:
# - ./data/pgadmin-data:/var/lib/pgadmin
# - ./data/upload:/tmp/upload
# links:
# - "db:pgsql-server"
volumes:
db-data:
pgadmin-data:
```
# Html
# 【Html】自動重新整理方法
- #### header 加入 meta
```HTML
',
'查無使用者',
'
'
].join('\n'),
suggestion: function(data) {
return '' + data['USER_ID'] + '-' + data['AD_ID'] + '-' + data['USER_NAME'] + ' #' + data['EXT'] + '
';
}
}
});
$('.typeahead').on('typeahead:select', function(event, data) {
selectFunc(event, data);
});
$('.typeahead').on('typeahead:change ', function(event, data) {
// console.log('change : ' , data);
});
$('.js_typeahead_reset_btn').on('click',function(){
$('.js_typeahead_reset').each(function(index,el){
$(el).val('');
});
});
// for(var i = 1;i<=5;i++){
// if($('.js_typeahead_reset_btn_'+i).length > 0){
// $('.js_typeahead_reset_btn_'+i).on('click',function(){
// $('.js_typeahead_reset_'+i).each(function(index,el){
// $(el).val('');
// });
// });
// }
// }
}
function isEmpty(str){
if(str === undefined || str.trim() === "" || str === null){
return true;
}
return false;
}
function getEditDataStr(beforDate,afterData){
var resultTextArr = [];
for(var key in beforDate){
if (afterData[key] !== undefined && beforDate[key] != afterData[key]
){
if (beforDate[key] == null && afterData[key] == '') continue;
resultTextArr.push(key+":"+beforDate[key]+"=>"+afterData[key]);
}
}
if(resultTextArr.length > 0){
return resultTextArr.join(",");
}else{
return "";
}
}
/* ==============================================================================================*/
function responseHandler(res) {
$.each(res.rows, function (i, row) {
row.state = $.inArray(row.dv_no, selections) !== -1;
});
return res;
}
function getHeight(_height) {
var _height = _height || 110;
return $(window).height() - $(".panel-heading").height() - _height;
}
// function getQueryParams(params){
// var queryParams = {};
// $(".query").each(function(i,e){
// var id = (e.id).replace("q_","");
// queryParams[id]=$(e).val();
// });
// $.extend(queryParams,params);
// console.log("getQueryParams",queryParams);
// return queryParams;
// }
function getQueryParams(params){
var queryParams = {};
$(".query").each(function(i,e){
var id = (e.id).replace("q_","");
queryParams[id]=$(e).val();
});
$.extend(queryParams,params);
return queryParams;
}
/* bootsrap table formatter */
function detailFormatter(index, row) {
var html = [];
var trans = [];
$.each(row, function (key, value) {
if (key != 'total' && key != 'check'){
var name=(trans[key] === undefined) ? key: trans[key];
var value=(value === null || value === undefined ) ? '': value;
html.push('' + name + ': ' + value + '
');
}
});
return html.join('');
}
function operateFormatter(value, row, index) {
return [
'',
' ',
'',
' ',
'',
' '
].join('');
}
function editFormatter(value, row, index){
return [
'',
' '
].join('');
}
function yesNoFormatter(value,row,index){
return (value == 1)?'是':'否';
}
function snFormatter(value,row,index) {
return index+1;
}
function scanNumberFormatter(data) {
return (data == 1)?'是':'否';
}
function totalTextFormatter(data) {
return 'Total';
}
function totalNameFormatter(data) {
return data.length;
}
function nowrapFormatter(){
return { css:{"whiie-space":"nowrap"}} ;
}
function totalPriceFormatter(data) {
var total = 0;
$.each(data, function (i, row) {
total += +(row.price.substring(1));
});
return '$' + total;
}
// function buildTable($el) {
// var i, j, row,
// columns = [],
// data = [];
// var opt = $el.bootstrapTable('getOptions');
// var fixedColumnsOption = { fixedColumns: true,fixedNumber: +$('#fixedNumber').val()};
// $.extend(opt,fixedColumnsOption);
// console.log("bootstrap_option",opt);
// $el.bootstrapTable('destroy').bootstrapTable(opt);
// }
$(window).resize(function () {
var $table = $table || null;
if($table !== null){
$table.bootstrapTable('resetView', {
height: getHeight()
});
}
});
```
選項設定預設值
```JavaScript
var DEFAULTS = {
height: undefined,
classes: 'table table-bordered table-hover',
buttons: {},
theadClasses: '',
headerStyle: function headerStyle(column) {
return {};
},
rowStyle: function rowStyle(row, index) {
return {};
},
rowAttributes: function rowAttributes(row, index) {
return {};
},
undefinedText: '-',
locale: undefined,
virtualScroll: false,
virtualScrollItemHeight: undefined,
sortable: true,
sortClass: undefined,
silentSort: true,
sortName: undefined,
sortOrder: undefined,
sortReset: false,
sortStable: false,
rememberOrder: false,
serverSort: true,
customSort: undefined,
columns: [[]],
data: [],
url: undefined,
method: 'get',
cache: true,
contentType: 'application/json',
dataType: 'json',
ajax: undefined,
ajaxOptions: {},
queryParams: function queryParams(params) {
return params;
},
queryParamsType: 'limit',
// 'limit', undefined
responseHandler: function responseHandler(res) {
return res;
},
totalField: 'total',
totalNotFilteredField: 'totalNotFiltered',
dataField: 'rows',
footerField: 'footer',
pagination: false,
paginationParts: ['pageInfo', 'pageSize', 'pageList'],
showExtendedPagination: false,
paginationLoop: true,
sidePagination: 'client',
// client or server
totalRows: 0,
totalNotFiltered: 0,
pageNumber: 1,
pageSize: 10,
pageList: [10, 25, 50, 100],
paginationHAlign: 'right',
// right, left
paginationVAlign: 'bottom',
// bottom, top, both
paginationDetailHAlign: 'left',
// right, left
paginationPreText: '‹',
paginationNextText: '›',
paginationSuccessivelySize: 5,
// Maximum successively number of pages in a row
paginationPagesBySide: 1,
// Number of pages on each side (right, left) of the current page.
paginationUseIntermediate: false,
// Calculate intermediate pages for quick access
search: false,
searchHighlight: false,
searchOnEnterKey: false,
strictSearch: false,
regexSearch: false,
searchSelector: false,
visibleSearch: false,
showButtonIcons: true,
showButtonText: false,
showSearchButton: false,
showSearchClearButton: false,
trimOnSearch: true,
searchAlign: 'right',
searchTimeOut: 500,
searchText: '',
customSearch: undefined,
showHeader: true,
showFooter: false,
footerStyle: function footerStyle(column) {
return {};
},
searchAccentNeutralise: false,
showColumns: false,
showColumnsToggleAll: false,
showColumnsSearch: false,
minimumCountColumns: 1,
showPaginationSwitch: false,
showRefresh: false,
showToggle: false,
showFullscreen: false,
smartDisplay: true,
escape: false,
filterOptions: {
filterAlgorithm: 'and'
},
idField: undefined,
selectItemName: 'btSelectItem',
clickToSelect: false,
ignoreClickToSelectOn: function ignoreClickToSelectOn(_ref) {
var tagName = _ref.tagName;
return ['A', 'BUTTON'].includes(tagName);
},
singleSelect: false,
checkboxHeader: true,
maintainMetaData: false,
multipleSelectRow: false,
uniqueId: undefined,
cardView: false,
detailView: false,
detailViewIcon: true,
detailViewByClick: false,
detailViewAlign: 'left',
detailFormatter: function detailFormatter(index, row) {
return '';
},
detailFilter: function detailFilter(index, row) {
return true;
},
toolbar: undefined,
toolbarAlign: 'left',
buttonsToolbar: undefined,
buttonsAlign: 'right',
buttonsOrder: ['paginationSwitch', 'refresh', 'toggle', 'fullscreen', 'columns'],
buttonsPrefix: CONSTANTS.classes.buttonsPrefix,
buttonsClass: CONSTANTS.classes.buttons,
icons: CONSTANTS.icons,
iconSize: undefined,
iconsPrefix: CONSTANTS.iconsPrefix,
// glyphicon or fa(font-awesome)
loadingFontSize: 'auto',
loadingTemplate: function loadingTemplate(loadingMessage) {
return "\n ".concat(loadingMessage, " \n \n ");
},
onAll: function onAll(name, args) {
return false;
},
onClickCell: function onClickCell(field, value, row, $element) {
return false;
},
onDblClickCell: function onDblClickCell(field, value, row, $element) {
return false;
},
onClickRow: function onClickRow(item, $element) {
return false;
},
onDblClickRow: function onDblClickRow(item, $element) {
return false;
},
onSort: function onSort(name, order) {
return false;
},
onCheck: function onCheck(row) {
return false;
},
onUncheck: function onUncheck(row) {
return false;
},
onCheckAll: function onCheckAll(rows) {
return false;
},
onUncheckAll: function onUncheckAll(rows) {
return false;
},
onCheckSome: function onCheckSome(rows) {
return false;
},
onUncheckSome: function onUncheckSome(rows) {
return false;
},
onLoadSuccess: function onLoadSuccess(data) {
return false;
},
onLoadError: function onLoadError(status) {
return false;
},
onColumnSwitch: function onColumnSwitch(field, checked) {
return false;
},
onPageChange: function onPageChange(number, size) {
return false;
},
onSearch: function onSearch(text) {
return false;
},
onToggle: function onToggle(cardView) {
return false;
},
onPreBody: function onPreBody(data) {
return false;
},
onPostBody: function onPostBody() {
return false;
},
onPostHeader: function onPostHeader() {
return false;
},
onPostFooter: function onPostFooter() {
return false;
},
onExpandRow: function onExpandRow(index, row, $detail) {
return false;
},
onCollapseRow: function onCollapseRow(index, row) {
return false;
},
onRefreshOptions: function onRefreshOptions(options) {
return false;
},
onRefresh: function onRefresh(params) {
return false;
},
onResetView: function onResetView() {
return false;
},
onScrollBody: function onScrollBody() {
return false;
},
onTogglePagination: function onTogglePagination(newState) {
return false;
}
};
```
# 【ES6】其他新語法
### 預設值
```JavaScript
function sum(a, b = 1) { // 加入預設值避免錯誤
return a + b;
}
console.log(sum(1));
```
# 【ES6】物件拷貝
淺層拷貝(只複製一層，內容物件還是參考至同一位址)
```JavaScript
const person = {
name: '小明',
obj: {}
}
const person2 = {...person} //方法1
const person3 = Object.assign({},person); //方法2
```
深層拷貝
```JavaScript
const person = {
name: '小明',
obj: {}
}
// 使用josn轉成字串，再轉回物件
const person2 = JSON.parse(JSON.stringify(person))
```
# 【ES6】物件拷貝
淺層拷貝(只複製一層，內容物件還是參考至同一位址)
```JavaScript
const person = {
name: '小明',
obj: {}
}
const person2 = {...person} //方法1
const person3 = Object.assign({},person); //方法2
```
深層拷貝
```JavaScript
const person = {
name: '小明',
obj: {}
}
// 使用josn轉成字串，再轉回物件
const person2 = JSON.parse(JSON.stringify(person))
```
# 【ES6】非同步 與 promise
非同步
```JavaScript
function getData() {
setTimeout(() => {
console.log('... 已取得遠端資料');
}, 0);
}
// 請問取得資料的順序為何
function init() {
console.log(1);
getData();
console.log(2);
}
init();
////////////// result
1
2
... 已取得遠端資料
```
premise 使程式流程同步
```JavaScript
const promiseSetTimeout = (status) => {
return new Promise((resolve, reject) => {
setTimeout(() => {
if (status) {
resolve('promiseSetTimeout 成功')
} else {
reject('promiseSetTimeout 失敗')
}
}, 0);
})
}
// #2-1 基礎運用 (成功用 then 捕捉, 失敗用 catch捕捉)
// 呼叫成功
console.log(1)
promiseSetTimeout(1)
.then((res)=>{
console.log(res);
})
.catch((err)=>{
console.log(err);
})
console.log(2)
/** result
1
promiseSetTimeout 成功
2
*/
// 呼叫失敗
console.log(1)
promiseSetTimeout(2)
.then((res)=>{
console.log(res);
})
.catch((err)=>{
console.log(err);
})
console.log(2)
/** result
1
promiseSetTimeout 失敗
2
*/
```
promise 串接 ( 不使用巢狀寫法)
```JavaScript
promiseSetTimeout(1)
.then((res)=>{
console.log(res);
// 使用return 發起第二次非同步
return promiseSetTimeout(1);
})
// 第二次非同步成功
.then((res) => {
console.log("第二次非同步成功");
})
```
# 【ES6】展開
### 合併陣列
```JavaScript
const groupA = ['小明', '杰倫', '阿姨'];
const groupB = ['老媽', '老爸'];
const groupC = [...groupA,...groupB]; //'小明', '杰倫', '阿姨', '老媽', '老爸'
```
### 繼承物件
```JavaScript
const methods = {
fn1() {
console.log(1);
},
fn2() {
console.log(1);
},
}
const methods2 = {
...methods,
fn3(){
console.log(1);
}
}
```
### 轉換為純陣列
```JavaScript
// NodeList 或 HTMLCollection 或 Arguments 是「類陣列」的物件
// 無法使用 map 等純物件的方法
const doms = document.querySelectorAll('li');
console.log(doms);
// 轉為純陣列
const newDom = [...doms];
newDom.map((item,i)=>{
console.log(i);
});
```
# 【ES6】陣列方法
[https://www.youtube.com/watch?v=\_vFuDQ\_6Xt8](https://www.youtube.com/watch?v=_vFuDQ_6Xt8)
# 【ES6】箭頭函式
### 改寫原 functoin
```JavaScript
// 傳統寫法
function fn(a, b) {
return a * b;
}
// 箭頭函式
const fn = (a, b) => {
return a * b;
}
// 省略 return
const fn = (a, b) => {
a * b;
}
/////////////////////////////
function fn(name) {
return "Hello"+name;
}
// 單行省略 return , {}
const fn = (name) => "Hello "+name;
```
### this 指向不會指向全域，而是指向自己
```JavaScript
var name = '全域'
const person = {
name: '小明',
callName: function () {
console.log('1', this.name); // 1 小明
setTimeout(function () {
console.log('2', this.name); // 2 全域
console.log('3', this); // 3 window
}, 10);
},
}
```
# 【ES6】賦值解構
### 取出特定值作為變數
```JavaScript
// #1 取出特定值作為變數
const person = {
name: '小明',
age: 16,
like: '鍋燒意麵'
}
const {name, age} = person;
console.log(name, age); // 小明, 16
```
### 陣列解構
```shell
const arr = ['小明', '杰倫', '漂亮阿姨'];
const [Ming, Jay ] = arr;
console.log(Ming, Jay); // '小明', '杰倫'
```
### 解構加展開
```JavaScript
const people = {
Ming: {
name: '小明',
age: 16,
like: '鍋燒意麵'
},
Jay: {
name: '杰倫',
age: 18,
like: '跑車'
},
Auntie: {
name: '漂亮阿姨',
age: 22,
like: '名牌包'
}
}
const { Ming,...other} = people;
console.log(Ming, other );
// Ming
// {
// name: '小明',
// age: 16,
// like: '鍋燒意麵'
// }
// other
// {
// Jay: {
// name: '杰倫',
// age: 18,
// like: '跑車'
// },
// Auntie: {
// name: '漂亮阿姨',
// age: 22,
// like: '名牌包'
// }
// }
```
### 解構加上重新命名
```JavaScript
// 冒號：別名
const { Ming:AAA,...other} = people;
console.log(AAA, other );
```
### 函式參數解構
```JavaScript
const person = {name: "Sam", age: 18};
const fn = function({name, age}){
console.log(name,age)
}
fn(person); // Sam 18
```
### 解構在React應用
###
```JavaScript
const { useState } = React;
```
# 【ES6】async / await
### 使用方式
```JavaScript
// #1 當資料有順序性的時候
const fn1 = () =>{
axios.get("https://randomuser.me/api/")
.then((res)=> {
console.log("fn1 seed",res.data.info.seed);
const seed = res.data.info.seed;
return axios.get(`https://randomuser.me/api/?seed=${seed}`)
})
.then((res)=>{
console.log("fn1 seed2",res.data.info.seed)
})
}
// #2 使用 async await 來修改
const fn2 = async ()=> {
const res = await axios.get("https://randomuser.me/api/")
const seed = res.data.info.seed;
console.log("fn2 seed",res.data.info.seed);
const res2 = await axios.get(`https://randomuser.me/api/?seed=${seed}`);
const seed2 = res2.data.info.seed;
console.log("fn2 seed2",res2.data.info.seed);
}
// #3 立即函式的寫法
(async function(){
const res = await axios.get("https://randomuser.me/api/")
const seed = res.data.info.seed;
console.log("fn3 seed",res.data.info.seed);
const res2 = await axios.get(`https://randomuser.me/api/?seed=${seed}`);
const seed2 = res2.data.info.seed;
console.log("fn3 seed2",res2.data.info.seed);
})();
```
### 錯誤處理
```JavaScript
const fn4 = async () => {
try {
const res = await axios.get("https://randomuser.me/api/")
return res
} catch (error) {
throw error
}
}
fn4()
.then((res)=>{
console.log(res);
})
.catch((err)=>{
console.log(err);
});
```
### async function 本身就是 promise
[](https://bookstack.treemanou.com/uploads/images/gallery/2023-01/MPzDB9hd4GsVTixg-image-1674748127619.png)
### async Function 與 React
```JavaScript
// async Function 與 React
const App = () => {
const [data, setData] = React.useState({})
React.useEffect(() => {
(async () => {
const res = await axios.get('https://jsonplaceholder.typicode.com/todos/1');
console.log(res);
setData(res.data);
})();
}, []);
return
{data.title}
}
```
# 【ES6】ESModual
[](https://bookstack.treemanou.com/uploads/images/gallery/2023-01/EuEw8ikkjfuNOjuR-image-1674749911584.png)
### 什麼樣的匯出對應什麼樣的匯入
#### 預設匯入(一個匯出檔只能有一個)
常見的匯出方式，通常用於匯出物件，在 React 開發中可用來匯出元件
可用於匯出已定義的變數、物件、函式，專案開發中通常用於 “方法匯出”
第三方的框架、函式、套件很常使用具名定義 “方法 ”
- `null`
- `undefined`
- `0`
- `""` (空字串)
- `NaN`
- `false`
特性 || (OR) ?? (Nullish) **觸發預設值的條件** 任何 Falsy 值 (0, "", false...) 僅限 null 或 undefined **對 0 的處理** 視為 False，會被預設值覆蓋 視為有效值，保留 0 **對 "" (空字串) 的處理** 視為 False，會被預設值覆蓋 視為有效值，保留 "" **設計目的** 廣泛的邏輯備案 精確處理「缺失資料」
## 實戰範例
假設我們正在開發一個使用者設定頁面：
```
const userSettings = {
speed : 0 ,
nickname : "" ,
isPremium : false ,
theme : null
};
console .log(userSettings.speed || 10 );
console .log(userSettings.nickname || "匿名" );
console .log(userSettings.isPremium || true );
console .log(userSettings.speed ?? 10 );
console .log(userSettings.nickname ?? "匿名" );
console .log(userSettings.isPremium ?? true );
console .log(userSettings.theme ?? "Light" );
```
---
- 處理 API 回傳的選擇性參數。
- 數值計算（例如：計數器、座標）。
- UI 表單輸入（允許空字串）。
- 舊版瀏覽器相容性（`??` 是 ES2020 引入的）。
- 確保變數一定有「實質內容」（非空、非零）。
---
```
const result = (a || b) ?? c;
```
如果出現面下錯誤提示：
\[Deploy to Production\] Host key verification failed.
\[Deploy to Production\] lost connection
解決思路如下：
請改用如下命令
1\.
scp -o StrictHostKeyChecking=no -i /Users/gaoyan/Documents/SunnyDemo/dev/tomcat-demo.pem.txt webapp/target/webapp.war ec2-user@52.15.183.253:/var/lib/tomcat8/webapps
加了-o StrictHostKeyChecking=no參數， 這樣主機密鑰就會在連接時自動加入到known\_hosts中去
2\.
命令行也用加了-o參數的命令手動登錄試試
ssh -o StrictHostKeyChecking=no ec2-user@13.58.179.83 -i tomcat-demo.pem.txt
這樣主機密鑰就會在連接時自動加入到known\_hosts中去
3.保證用jenkins執行的時候 tomcat-demo.pem.txt這個文件其他用戶對他有操作權，但是注意執行上面第二個命令時，會提示其他人不能對這個文件有訪問權，所以用sudo chmod 700 tomcat-demo.pem.txt， 執行完這個命令以後，再把權限改成 644， sudo chmod 644 tomcat-demo.pem.txt， 然後去jenkins執行第一條命令
4.還不成功刪除known\_hosts試試， cd~/.ssh
rm known\_hosts
如果出現：
Permissions 0644 for 'jenkinskey.pem' are too open.
It is required that your private key files are NOT accessible by others.
This private key will be ignored.
Load key "jenkinskey.pem": bad permissions
解決辦法：
chmod 400 pem\_filename.pem
Script Path **: `jobs/ithome-day3-sample-job/Jenkinsfile` => pipline 檔案
[](https://bookstack.treemanou.com/uploads/images/gallery/2025-03/rdW2ZbC7Ob5XVFUg-image-1742440086893.png)
[](https://bookstack.treemanou.com/uploads/images/gallery/2025-03/bKmjP7SZeqiwEjth-image-1742440093950.png)
# 【Jenkins】 on macOS 速查表
## 1. 安裝流程
```bash
# 更新 Homebrew 自身與套件清單
brew update
# （可選）升級已安裝的套件
brew upgrade
# 安裝 Jenkins LTS（穩定版）
brew install jenkins-lts
```
---
## 2. 啟動 / 停止 / 重啟 Jenkins
```bash
# 啟動 Jenkins 服務（開機自動啟動）
brew services start jenkins-lts
# 停止 Jenkins 服務
brew services stop jenkins-lts
# 重啟 Jenkins 服務
brew services restart jenkins-lts
# 手動啟動（非守護行程模式，終端機關掉就結束）
jenkins-lts
```
---
## 3. Jenkins 預設資訊
- **預設 Port**: `8080`
👉 瀏覽器打開 [http://localhost:8080](http://localhost:8080/)
- **初始管理員密碼**（第一次登入需要）：
```bash
cat ~/.jenkins/secrets/initialAdminPassword
```
---
## 4. 常見檢查
```bash
# 檢查 Jenkins 是否有在跑
curl http://localhost:8080
# 查看 Jenkins log
tail -f /usr/local/var/log/jenkins.log
```
---
## 5. 升級 Jenkins
```bash
# 更新 Homebrew 清單
brew update
# 升級 Jenkins
brew upgrade jenkins-lts
# 重啟服務讓新版生效
brew services restart jenkins-lts
```
---
## 6. 移除 Jenkins
```bash
brew services stop jenkins-lts
brew uninstall jenkins-lts
```
---
📌 建議：
- **第一次安裝後**，記得把初始密碼存起來，避免找不到。
- **長期使用**：定期跑 `brew update && brew upgrade`，保持 Jenkins 最新。
---
要不要我再幫你整理一份 **對照表格**（指令 → 功能），方便你 copy 貼到筆記？
# K8s
# 相關資源
### Kubernetes in Action
[https://fanatical-dentist-b1d.notion.site/Kubernetes-in-Action-8ac92f08a3fd41028ed1ae20cdc7a007](https://fanatical-dentist-b1d.notion.site/Kubernetes-in-Action-8ac92f08a3fd41028ed1ae20cdc7a007)
### Kubernetes in Action2
[https://fanatical-dentist-b1d.notion.site/Kubernetes-in-Action2-4d565efc45124bc989484c8cdb7df181](https://fanatical-dentist-b1d.notion.site/Kubernetes-in-Action2-4d565efc45124bc989484c8cdb7df181)
### Kubernetes 官方文檔(簡中)
[https://kubernetes.io/zh-cn/docs/home/](https://kubernetes.io/zh-cn/docs/home/)
### Kubernetes 考試相關
[https://kubernetes.io/docs/reference/kubectl/overvie](https://kubernetes.io/docs/reference/kubectl/overview/)[w/](https://kubernetes.io/docs/reference/kubectl/overview/)
[https://kubernetes.io/docs/reference/kubectl/cheatsheet](https://kubernetes.io/docs/reference/kubectl/cheatsheet)/
# Kind 簡易說明
## **K8s Workload**
[](https://bookstack.treemanou.com/uploads/images/gallery/2024-12/hwk1XdvpyG7CuWKk-image-1735010531186.png)
[](https://bookstack.treemanou.com/uploads/images/gallery/2024-12/roU8JO1qSZLqreXE-image-1735010627965.png)
以下是 **DaemonSet**、**StatefulSet**、**ReplicaSet** 和 **Deployment** 的詳細比較：
**特性** **DaemonSet** **StatefulSet** **ReplicaSet** **Deployment** **用途** 確保每個 Node 上運行一個 Pod 副本。 部署有狀態的應用，每個 Pod 都有固定標識。 確保指定數量的 Pod 副本運行。 管理 Pod 和 ReplicaSet，提供滾動更新功能。 **典型場景** 日誌收集器、監控代理等需要全節點覆蓋。 資料庫、分佈式系統等需要穩定標識或存儲的應用。 確保無狀態應用的高可用性。 部署和管理無狀態應用，支持版本控制和更新。 **Pod 名稱** 名稱可變，與 Node 關聯，無固定格式。 有固定名稱（如 `db-0`, `db-1`）。 無固定格式，與 Deployment 類似。 通常由 Deployment 自動生成，不直接管理 Pod。 **存儲** 不涉及持久化存儲，通常為臨時存儲。 每個 Pod 可關聯專屬持久存儲。 通常無需存儲，支持臨時存儲。 通常無需存儲，支持無狀態應用。 **縮放（副本數）** 無法指定副本數，與 Node 數量相關。 支持指定副本數，且保證順序和標識穩定。 支持指定副本數，所有副本平等。 支持指定副本數，自動調整和滾動更新。 **更新方式** 滾動更新，逐一更新節點上的 Pod。 滾動更新，有序處理 Pod，確保依賴順序。 滾動更新，副本數量保持穩定。 滾動更新，支持回滾和藍綠部署策略。 **依賴的資源** 與 Node 關聯，不依賴其他資源。 通常依賴持久化存儲（如 PVC）。 通常不依賴其他資源。 自動創建和管理 ReplicaSet。 **伸縮性** 固定與 Node 數量匹配，無法手動調整。 可靈活擴展，並保證 Pod 的穩定標識。 手動指定副本數，無狀態，副本之間無區別。 自動管理副本數，支持水平和垂直擴展。 **依賴順序** Pod 啟動順序無依賴。 Pod 啟動和刪除有順序，確保依賴關係。 無順序依賴，隨機啟動和刪除。 無順序依賴，通常關注應用級別的管理。 **高可用性** 和 Node 數量相關，通常與節點數一致。 通過固定標識和穩定的存儲保證高可用性。 通過多副本保證高可用性，但不管理應用版本。 提供高可用性並支持應用升級與版本回滾。
---
### **適用場景總結**
1. **DaemonSet**：
- 用於需要在所有 Node 上部署的服務，例如：
- 日誌收集器（如 Fluentd）。
- 監控代理（如 Prometheus Node Exporter）。
- 網絡插件（如 Calico, Weave）。
2. **StatefulSet**：
- 適用於需要穩定標識和存儲的有狀態應用，例如：
- 資料庫（如 MySQL, PostgreSQL）。
- 分布式系統（如 Kafka, ZooKeeper）。
- 需要保持 Pod 順序的應用。
3. **ReplicaSet**：
- 用於確保固定數量的無狀態 Pod 副本運行，例如：
- 部署應用的核心部分，但一般由 Deployment 自動管理。
4. **Deployment**：
- 最常用於管理無狀態應用，支持滾動更新、版本控制和自動擴展，例如：
- Web 應用（如 Nginx, Node.js）。
- 微服務應用的部署。
這樣的比較有助於釐清這些資源的功能和適用情境，幫助在實際項目中選擇合適的解決方案。
在 Kubernetes 中，`Service` 的 `type` 定義了服務的訪問方式和範圍。以下是 Kubernetes 支持的四種類型及其用途說明：
---
## Service 的四種Type
### [](https://bookstack.treemanou.com/uploads/images/gallery/2024-12/Vf0uxFIwmKlWsrjt-image-1735011766578.png)
### 1. **ClusterIP (預設類型)**
- **說明**：
- 僅限於集群內部的虛擬 IP，用於服務發現和內部通信。
- 外部無法直接訪問。
- **用途**：
- 用於內部微服務之間的通信。
- 通常搭配 DNS（如 `kube-dns`）進行名稱解析。
- **範例**：
```yaml
apiVersion: v1
kind: Service
metadata:
name: clusterip-service
spec:
type: ClusterIP
selector:
app: my-app
ports:
- protocol: TCP
port: 80
targetPort: 8080
```
---
### 2. **NodePort**
- **說明**：
- 將服務暴露在每個節點的固定端口上（範圍：30000-32767）。
- 用戶可以通過 `:` 訪問服務。
- **用途**：
- 測試環境中，用於將服務暴露給集群外部的用戶。
- 生產環境中通常搭配 **Ingress** 或 **LoadBalancer**。
- **範例**：
```yaml
apiVersion: v1
kind: Service
metadata:
name: nodeport-service
spec:
type: NodePort
selector:
app: my-app
ports:
- protocol: TCP
port: 80
targetPort: 8080
nodePort: 30007
```
---
### 3. **LoadBalancer**
- **說明**：
- 在雲提供商（如 GCP、AWS 或 Azure）中創建外部負載均衡器，並將流量轉發到 Service。
- 每個 LoadBalancer 類型的 Service 都會自動獲得一個外部 IP。
- **用途**：
- 用於公開服務給互聯網，用於生產環境。
- 支持流量負載均衡。
- **範例**：
```yaml
apiVersion: v1
kind: Service
metadata:
name: loadbalancer-service
spec:
type: LoadBalancer
selector:
app: my-app
ports:
- protocol: TCP
port: 80
targetPort: 8080
```
---
### 4. **ExternalName**
- **說明**：
- 將 Service 名稱映射到外部 DNS 名稱。
- 不會創建 ClusterIP，也無法進行內部流量轉發。
- **用途**：
- 將 Kubernetes 內部服務請求代理到集群外部的服務。
- **範例**：
```yaml
apiVersion: v1
kind: Service
metadata:
name: externalname-service
spec:
type: ExternalName
externalName: external.example.com
```
---
### **服務類型對比**
**類型** **是否對外暴露** **訪問方式** **典型使用場景** **ClusterIP** 否 集群內部通信，使用虛擬 IP 微服務之間的內部通信。 **NodePort** 是 `:` 測試環境或簡單的外部訪問。 **LoadBalancer** 是 自動分配外部 IP 公開服務到互聯網，支持負載均衡。 **ExternalName** 是（間接） 使用外部 DNS 名稱解析 將內部服務請求代理到集群外部服務。
---
### 適用場景建議
1. **ClusterIP**：適合內部微服務的互相調用，默認類型。
2. **NodePort**：適合小型測試環境，簡單公開服務。
3. **LoadBalancer**：適合生產環境，需要高可用的負載均衡服務。
4. **ExternalName**：適合需要訪問外部資源但想使用 Kubernetes 內部 DNS 管理的情況。
這些 `type` 結合不同的網絡需求，靈活應對各種應用場景。
---
## YML 的各種 Kind
**Kind** **說明** **用途** **Pod** Kubernetes 中最小的執行單位，包含容器。 部署單個應用程式容器。 **Job** 執行一次性任務，確保成功完成。 運行批處理任務。 **CronJob** 定期執行的任務。 排程任務（如每天備份數據）。 **StatefulSet** 管理有狀態的應用。 部署需固定標識或穩定存儲的 Pod。 **ReplicaSet** 確保指定數量的 Pod 始終運行。 通常由 Deployment 管理，用於維持 Pod 副本數。 **DaemonSet** 確保每個 Node 上運行一個 Pod 副本。 部署監控代理、日誌收集器等。 **Deployment** 管理 Pod 和 ReplicaSet，支持滾動更新。 部署無狀態應用，保持指定數量的 Pod 運行。 **Service** 定義 Pod 的網絡訪問規則。 將外部流量路由到 Pod，提供負載均衡。 **Ingress** 提供 HTTP/HTTPS 路由規則。 公開訪問服務，支持負載均衡和基於域名的路由。 **NodePort** 將外部流量映射到指定節點端口。 將集群外部訪問直接映射到內部 Service，通常為開發測試用途。 **ConfigMap** 存儲非機密配置數據。 將配置注入 Pod（環境變量或掛載文件）。 **Secret** 存儲機密數據（如密碼、API 密鑰）。 安全地將敏感信息注入 Pod。 **PersistentVolume (PV)** 定義持久化存儲。 提供存儲資源，獨立於 Pod 的生命週期。 **PersistentVolumeClaim (PVC)** 申請 PersistentVolume。 Pod 使用 PVC 來請求持久存儲資源。 **Namespace** 將資源分隔成不同的邏輯組。 支持多租戶環境。 **Role 和 ClusterRole** 定義訪問權限。 管控資源的讀寫權限，`Role` 限於 Namespace，`ClusterRole` 全集群。 **RoleBinding 和 ClusterRoleBinding** 綁定訪問權限到用戶。 授權用戶或服務帳號訪問權限。 **HorizontalPodAutoscaler (HPA)** 根據指標自動調整 Pod 副本數量。 提高應用的彈性擴展能力。
---
### 範例 YAML 說明
#### **1. CronJob**
執行每天凌晨 12 點的數據備份：
```yaml
apiVersion: batch/v1
kind: CronJob
metadata:
name: daily-backup
spec:
schedule: "0 0 * * *"
jobTemplate:
spec:
template:
spec:
containers:
- name: backup
image: backup-tool:latest
args:
- /bin/sh
- -c
- "backup-script.sh"
restartPolicy: OnFailure
```
---
#### **2. DaemonSet**
在每個 Node 上部署日誌收集器：
```yaml
apiVersion: apps/v1
kind: DaemonSet
metadata:
name: log-collector
spec:
selector:
matchLabels:
app: log-collector
template:
metadata:
labels:
app: log-collector
spec:
containers:
- name: log-collector
image: log-collector:latest
```
---
#### **3. Deployment**
部署一個無狀態 Web 應用，副本數為 3：
```yaml
apiVersion: apps/v1
kind: Deployment
metadata:
name: web-app
spec:
replicas: 3
selector:
matchLabels:
app: web-app
template:
metadata:
labels:
app: web-app
spec:
containers:
- name: web
image: nginx:latest
ports:
- containerPort: 80
```
---
#### **4. Job**
執行一次性任務：
```yaml
apiVersion: batch/v1
kind: Job
metadata:
name: one-time-task
spec:
template:
spec:
containers:
- name: task-runner
image: busybox
args:
- /bin/sh
- -c
- "echo Hello, Kubernetes!"
restartPolicy: OnFailure
```
---
#### **5. StatefulSet**
部署有狀態的數據庫應用：
```yaml
apiVersion: apps/v1
kind: StatefulSet
metadata:
name: database
spec:
serviceName: "database-service"
replicas: 3
selector:
matchLabels:
app: database
template:
metadata:
labels:
app: database
spec:
containers:
- name: db
image: mysql:5.7
env:
- name: MYSQL_ROOT_PASSWORD
value: "password"
ports:
- containerPort: 3306
```
---
#### **6. Pod**
部署一個單一容器的應用：
```yaml
apiVersion: v1
kind: Pod
metadata:
name: single-app
spec:
containers:
- name: app
image: busybox
args:
- /bin/sh
- -c
- "echo Running a single pod!"
```
#### **1. CronJob**
執行每天凌晨 12 點的數據備份：
```yaml
apiVersion: batch/v1
kind: CronJob
metadata:
name: daily-backup
spec:
schedule: "0 0 * * *"
jobTemplate:
spec:
template:
spec:
containers:
- name: backup
image: backup-tool:latest
args:
- /bin/sh
- -c
- "backup-script.sh"
restartPolicy: OnFailure
```
---
#### **2. Service**
定義一個 Service，將流量路由到 Pod：
```yaml
apiVersion: v1
kind: Service
metadata:
name: web-app-service
spec:
selector:
app: web-app
ports:
- protocol: TCP
port: 80
targetPort: 80
type: ClusterIP
```
- **說明**: 這個 Service 將把進入集群內部的流量路由到標籤 `app: web-app` 的 Pod。
###
#### **NodePort 範例**
以下是一個簡單的 **NodePort** 配置範例，用於將集群外部的請求轉發到內部的 Pod：
```yaml
apiVersion: v1
kind: Service
metadata:
name: nodeport-service
spec:
type: NodePort
selector:
app: my-app
ports:
- protocol: TCP
port: 80 # ClusterIP 的服務端口
targetPort: 8080 # Pod 內部容器的端口
nodePort: 30007 # 節點上的固定外部端口（30000~32767 之間）
```
- **說明**：
- **`type: NodePort`**：指定此服務為 NodePort 類型。
- **`nodePort`**：設置固定的外部端口，供外部用戶通過 `:30007` 訪問服務。
- **適用場景**：開發測試環境或簡單的外部訪問，不建議用於生產環境，因為其功能有限且缺乏靈活性。
---
# kubectl常用命令
### `kubectl` 常用指令表格（繁體中文）
以下是 **`kubectl` 常用指令**的表格整理，包含了集群資訊查看、資源管理、排錯調試、日誌查看等各類常用操作，方便你快速查找和使用。
---
**功能分類** **指令** **說明** **集群資訊** `kubectl version` 查看客戶端和伺服器的版本資訊 `kubectl cluster-info` 查看集群的基本資訊 `kubectl get nodes` 列出所有節點（Nodes） `kubectl describe node ` 查看指定節點的詳細資訊 **查看資源** `kubectl get pods` 查看目前命名空間的所有 Pods `kubectl get pods -n ` 查看指定命名空間的 Pods `kubectl get services` 查看目前命名空間的所有 Services `kubectl get deployments` 查看目前命名空間的所有 Deployments `kubectl get all` 查看目前命名空間的所有資源 **查看詳細資訊** `kubectl describe pod ` 查看 Pod 的詳細資訊 `kubectl describe svc ` 查看 Service 的詳細資訊 **創建資源** `kubectl apply -f ` 使用 YAML 文件創建或更新資源 `kubectl create deployment` 創建一個新的 Deployment **更新資源** `kubectl edit ` 直接編輯現有資源 **刪除資源** `kubectl delete pod ` 刪除指定的 Pod `kubectl delete -f ` 根據 YAML 文件刪除資源 **查看日誌** `kubectl logs ` 查看指定 Pod 的日誌 `kubectl logs -f` 即時追蹤 Pod 的日誌 `kubectl logs --tail=100` 查看最近 100 行的 Pod 日誌 **執行指令** `kubectl exec -it -- bash` 進入 Pod 的終端 `kubectl exec -- ` 在 Pod 中執行指定的指令 **排錯與調試** `kubectl describe pod ` 查看 Pod 的詳細資訊，用於排查錯誤 `kubectl get events` 查看集群的事件日誌 `kubectl top node` 查看節點的資源使用狀況 `kubectl top pod` 查看 Pod 的資源使用狀況 **命名空間管理** `kubectl get ns` 查看所有命名空間 `kubectl create namespace ` 創建新的命名空間 `kubectl delete namespace ` 刪除指定的命名空間 **配置管理** `kubectl config view` 查看當前的 kubeconfig 配置 `kubectl config get-contexts` 查看可用的上下文（Contexts） `kubectl config use-context ` 切換至指定的上下文 **YAML 輸出** `kubectl get -o yaml` 將資源輸出為 YAML 格式 **監控資源** `kubectl get pods --watch` 即時監控 Pod 的狀態變化 **滾動更新** `kubectl rollout status ` 查看 Deployment 的滾動更新狀態 `kubectl rollout undo ` 回滾 Deployment 至上一版本
**欄位名稱** **說明** apiVersion API 版本 kind 資源類型 metadata 資源元數據 spec 資源規格 replicas 副本數量 selector 標籤選擇器 template Pod 模板 metadata Pod 元數據 spec Pod 規格 containers 容器配置
使用kubectl create 生成 yaml 文件
```
kubectl create deployment web --image=nginx -o yaml --dry-run > my1.yaml
```
使用kubectl get 導出 yaml 文件
```
kubectl get deploy niginx -o=yaml --export > my2.yaml
```
# Pod 基本概念
[](https://bookstack.treemanou.com/uploads/images/gallery/2025-01/XuFXzqHaaBDN1rFy-image-1736906344006.png)
[](https://bookstack.treemanou.com/uploads/images/gallery/2025-01/Cm8wfrdUpGALUOkz-image-1736906405688.png)
### Pod 概述
Pod 是 Kubernetes 系統中可以創建和管理的最小單位，是資源對象模型中由使用者創建或部署的最小資源對象模型，也是 Kubernetes 平台上運行容器化應用的資源對象。其他的資源對象都是用來支援或強化 Pod 的功能，例如：
- **控制器** 資源對象用來監控 Pod 的狀態
- **Service** 或 **Ingress** 資源對象用來暴露 Pod 引用外部訪問
- **PersistentVolume** 資源對象用來為 Pod 提供存儲等功能
Kubernetes 並不直接調度容器，而是調度 Pod。Pod 是由一個或多個容器組成的。
Pod 是 Kubernetes 的**最重要概念**。每一個 Pod 都有一個特殊的被稱為 **Pause 容器** 的容器。Pause 容器的鏡像對應於 Kubernetes 平台的一部分，負責維護 Pod 的網路命名空間及其他元數據。
除了 Pause 容器，每個 Pod 還包含一個或多個具備業務邏輯的使用者業務容器。
### 1. Pod 基本概念
1. 最小部署單位
2. 包含多個容器（容器集合）
3. 一個 Pod 中的容器共享網路命名空間
4. Pod 是短暫的（不永久存在）
參數名稱 說明 `initialDelaySeconds` 首次檢查前的延遲時間 `periodSeconds` 每次檢查的間隔時間 `timeoutSeconds` 每次健康檢查的**超時時間** `successThreshold` 判定為**成功**所需的連續檢查次數 `failureThreshold` 判定為**失敗**所需的連續檢查次數
---
### **小結：**
- **`initialDelaySeconds`**：控制首次健康檢查的延遲時間。
- **`periodSeconds`**：控制每次健康檢查的間隔時間。
這些參數幫助 Kubernetes **有效管理容器的健康狀態**，從而避免過早或過頻的檢查導致誤判。
如果需要進一步解釋，請告訴我！😊
---
#### Probe 支援的三種檢查方法：
1. **httpGet**
- 發送 HTTP 請求，返回 200-400 範圍的狀態碼為成功。
2. **exec**
- 執行 Shell 命令，返回狀態碼為 0 為成功。
3. **tcpSocket**
- 發起 TCP Socket 建立成功。
---
### Kubernetes Pod 創建流程圖
#### **流程說明**：
1. **使用者** 向 **API Server** 發送 **create Pod** 的請求。
2. **API Server** 將 Pod 資訊 **寫入（write）** 到 **etcd**。
3. **etcd** 監控到 **新的 Pod** 被創建（`watch(new pod)`），通知 **Scheduler**。
4. **Scheduler** 將 Pod **綁定（bind pod）** 到節點。
5. **API Server** 再次將 **綁定資訊** 寫入 **etcd**。
6. **etcd** 監控到 **綁定的 Pod**（`watch(bound pod)`），通知 **Kubelet**。
7. **Kubelet** 監控到 **綁定的 Pod**，執行 **`docker run`** 指令來啟動容器。
8. **API Server** 更新 **Pod 狀態**，並將 **狀態更新資訊** 寫入 **etcd**。
[](https://bookstack.treemanou.com/uploads/images/gallery/2025-01/yEhEffJcecK4G2dZ-image-1736756174112.png)
以下是圖片中的文字辨識及繁體中文翻譯：
---
### **8.Pod 調度**
#### 影響調用的屬性
#### 1. Pod 資源限制對 Pod 調用產生影響
```yaml
resources:
requests:
memory: "64Mi"
cpu: "250m"
```
> 根據 `requests` 找到足夠資源的節點來進行 Pod 調度。
---
#### 2. 節點選擇器標籤對 Pod 調度的影響
```yaml
spec:
nodeSelector:
env_role: dev
containers:
- name: nginx
image: nginx:1.15
```
---
使用以下指令為節點打上標籤：
```bash
kubectl label node node1 env_role=prod
```
---
#### 3.節點親和性影響 Pod 調度
```yaml
apiVersion: v1
kind: Pod
metadata:
name: with-node-affinity
spec:
affinity:
nodeAffinity:
requiredDuringSchedulingIgnoredDuringExecution:
nodeSelectorTerms:
- matchExpressions:
- key: env_role
operator: In
values:
- dev
- test
preferredDuringSchedulingIgnoredDuringExecution:
- weight: 1
preference:
matchExpressions:
- key: group
operator: In
values:
- otherprod
containers:
- name: webdemo
image: nginx
```
---
##### **節點親和性（`nodeAffinity`）說明**
##### 節點親和性和 `nodeSelector` 基本一樣，根據節點上的標籤條件來決定 Pod 調度到哪些節點上。
1. **硬親和性**
- 使用 `requiredDuringSchedulingIgnoredDuringExecution`
- 條件必須滿足，否則無法調度到該節點。
2. **軟親和性**
- 使用 `preferredDuringSchedulingIgnoredDuringExecution`
- **嘗試滿足條件，但不保證**。如果滿足條件的節點可用，則優先調度到這些節點。
---
##### **重點區分**
- **硬親和性**：必須滿足條件，否則調度失敗。
- **軟親和性**：優先考慮符合條件的節點，但不強制。
---
# Controller 基本概念
## 1. **什麼是 Controller**
- 在集群上管理和運行容器的對象
---
## 2. **Pod 和 Controller 的關係**
- **Pod** 是通過 **Controller** 實現應用的運維，例如 **伸縮**、**滾動升級** 等
- **Pod 和 Controller** 之間通過 **label 標籤** 建立關係 (**selector**)
---
## 3. **Deployment 的應用場景**
- 部署 **無狀態應用**
- 管理 **Pod** 和 **ReplicaSet**
- 支援 **滾動升級**、**回滾**、**彈性伸縮** 等功能
#### **應用場景：**
- **Web 服務**
- **微服務**
---
以下是圖片中的文字辨識及繁體中文翻譯：
---
以下是圖片中的文字辨識及繁體中文翻譯：
---
### **4. 使用 Deployment 部署應用（YAML）**
```yaml
spec:
replicas: 1
selector:
matchLabels:
app: web
strategy: {}
template:
metadata:
creationTimestamp: null
labels:
app: web
```
---
### **說明：**
- **`selector`**：用於選擇符合特定標籤（`matchLabels`）的 Pod。
- **`matchLabels`**：指定要匹配的標籤條件，此處為 `app: web`。
- **`labels`**：在模板中定義 Pod 的標籤，確保與 `selector` 中的標籤條件一致。
此 YAML 文件表示使用 Deployment 部署一個副本的應用，並將其標籤設置為 `app: web`，以便進行管理和選擇。
---
## 5. **應用升級回滾和彈性伸縮**
#### **應用升級**
```bash
[root@k8smaster ~]# kubectl set image deployment web nginx=nginx:1.15
deployment.apps/web image updated
```
---
#### **查看升級狀態**
```bash
[root@k8smaster ~]# kubectl rollout status deployment web
deployment "web" successfully rolled out
```
---
#### **查看升級版本**
```bash
[root@k8smaster ~]# kubectl rollout history deployment web
deployment.apps/web
REVISION CHANGE-CAUSE
1
2
```
---
#### **回滾到上一個版本**
```bash
[root@k8smaster ~]# kubectl rollout undo deployment web
deployment.apps/web rolled back
[root@k8smaster ~]# kubectl rollout status deployment web
Waiting for deployment "web" rollout to finish: 1 old replicas are pending termination...
Waiting for deployment "web" rollout to finish: 1 old replicas are pending termination...
deployment "web" successfully rolled out
```
---
#### **回滾到指定的版本**
```bash
[root@k8smaster ~]# kubectl rollout undo deployment web --to-revision=2
deployment.apps/web rolled back
```
```bash
[root@k8smaster ~]# kubectl rollout status deployment web
Waiting for deployment "web" rollout to finish: 1 out of 2 new replicas have been updated...
Waiting for deployment "web" rollout to finish: 1 old replicas are pending termination...
deployment "web" successfully rolled out
```
---
#### **說明：**
- 使用 `--to-revision=2` 指定要回滾到的版本號。
- **`kubectl rollout status`** 用於查看回滾的進度，確認部署是否成功完成。
以下是圖片中的文字辨識及繁體中文翻譯：
---
#### **彈性伸縮**
```bash
[root@k8smaster ~]# kubectl scale deployment web --replicas=10
deployment.apps/web scaled
```
---
#### **說明：**
- 使用 `kubectl scale` 指令對 Deployment 進行彈性伸縮。
- **`--replicas=10`** 表示將 Pod 副本數量調整為 10。
此操作用於根據業務需求動態調整應用的容器數量，實現資源的彈性管理。
# Service 基本概念
服務發現
[](https://bookstack.treemanou.com/uploads/images/gallery/2025-01/gX9koeSWMn0HkT42-image-1736821738265.png)
[](https://bookstack.treemanou.com/uploads/images/gallery/2025-01/1OVr2BZBtK97bXM6-image-1736825475948.png)
以下是圖片內容的文字辨識及繁體中文翻譯：
---
## **1. 無狀態和有狀態**
### **(1) 無狀態：**
- 認為 **Pod** 都是一樣的
- 沒有順序要求
- 不用考慮在哪個 **Node** 運行
- 可以隨意進行伸縮和擴展
### **(2) 有狀態：**
- 上述因素都需要考慮到
- 讓每個 **Pod** 獨立，保持 **Pod** 啟動順序和唯一性
- 唯一的網路標識符，持久存儲
- 有順序，例如 **MySQL 主從**
---
## **2. 部署有狀態應用**
### **(1) 無頭 Service**
- **ClusterIP: None**
```yaml
apiVersion: v1
kind: Service
metadata:
name: nginx
labels:
app: nginx
spec:
ports:
- port: 80
name: web
clusterIP: None
selector:
app: nginx
```
---
### **(2) StatefulSet 部署有狀態應用**
```yaml
apiVersion: apps/v1
kind: StatefulSet
metadata:
name: nginx-statefulset
namespace: default
```
**指令：**
```bash
[root@k8smaster ~]# vi sts.yaml
[root@k8smaster ~]# kubectl apply -f sts.yaml
service/nginx created
statefulset.apps/nginx-statefulset created
```
---
### **說明：**
- **無頭 Service**：`ClusterIP: None` 用於有狀態應用，允許 Pod 之間直接通訊。
- **StatefulSet**：適用於有狀態應用，確保每個 Pod 都有唯一標識，並保證啟動順序。
---
以下是圖片內容的文字辨識及繁體中文翻譯：
---
### **查看 Pod**
- 有三個 Pod，每個都有唯一名稱：
```bash
[root@k8smaster ~]# kubectl get pods
NAME READY STATUS RESTARTS AGE
nginx-statefulset-0 1/1 Running 0 74s
nginx-statefulset-1 1/1 Running 0 40s
nginx-statefulset-2 1/1 Running 0 21s
```
---
### **Deployment 和 StatefulSet 的區別**
- StatefulSet 有身份的（唯一標識的）。
- 根據主機名 + 按照一定規則生成域名。
---
### **查看創建的無頭 Service**
```bash
NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE
kubernetes ClusterIP 10.96.0.1 443/TCP 6d17h
nginx ClusterIP None 80/TCP 2m12s
web NodePort 10.96.18.7 80:31819/TCP 50m
```
- **每個 Pod 有唯一主機名**
- **唯一域名**
### **格式：**
```
主機名稱.service名稱.命名空間.svc.cluster.local
```
### **示例：**
```
nginx-statefulset-0.nginx.default.svc.cluster.local
```
---
### **說明：**
- StatefulSet 通過主機名和域名，確保每個 Pod 都有唯一標識並支持有狀態應用。
- 無頭 Service 的 ClusterIP 為 `None`，允許 Pod 之間直接通信。
---
以下是圖片內容的文字辨識及繁體中文翻譯：
---
## **3. 部署守護進程 DaemonSet**
- **在每個 Node 上運行一個 Pod，新加入的 Node 也同樣運行在一個 Pod 裡面。**
### **示例：**
在每個 Node 節點安裝數據採集工具。
---
### **指令操作：**
1. **部署 DaemonSet：**
```bash
[root@k8smaster ~]# kubectl apply -f ds.yaml
daemonset.apps/ds-test created
```
2. **查看 Pod：**
```bash
[root@k8smaster ~]# kubectl get pods
NAME READY STATUS RESTARTS AGE
ds-test-cbk6v 0/1 ContainerCreating 0 0s
ds-test-cx6fk 1/1 Running 0 30s
```
3. **進入 Pod：**
```bash
[root@k8smaster ~]# kubectl exec -it ds-test-cbk6v bash
kubectl exec [POD] [COMMAND] is DEPRECATED and will be removed in future versions.
```
4. **查看文件：**
```bash
root@ds-test-cx6fk:/# ls /tmp/log
anaconda boot.log-20200902 containers firewalld
```
---
### **說明：**
- **DaemonSet** 用於確保每個 Node 上都執行一個 Pod，例如安裝系統監控、日誌收集、數據採集等工具。
- **特點：** 新加入的 Node 會自動部署相應的 Pod，適合全局性的守護進程需求。
# ConfigMap
以下是圖片內容的辨識及繁體中文翻譯，並補充完整 **1-4 步驟** 的詳細說明：
---
### **ConfigMap 操作步驟**
#### **1. 創建配置文件**
創建一個配置文件，例如 `redis.properties`：
```bash
[root@k8smaster ~]# vi redis.properties
# 文件內容
redis.host=127.0.0.1
redis.port=6379
redis.password=123456
```
---
#### **2. 創建 ConfigMap**
將配置文件創建為 ConfigMap：
```bash
[root@k8smaster ~]# kubectl create configmap redis-config --from-file=redis.properties
configmap/redis-config created
[root@k8smaster ~]# kubectl get cm
NAME DATA AGE
redis-config 1 10s
```
檢查 ConfigMap 詳情：
```bash
[root@k8smaster ~]# kubectl describe cm redis-config
Name: redis-config
Data:
redis.properties:
redis.host=127.0.0.1
redis.port=6379
redis.password=123456
```
---
#### **3. 以 Volume 形式挂載到 Pod 容器中**
**步驟：**
1. 編寫 YAML 文件，將 ConfigMap 作為 Volume 注入到 Pod 中：
```yaml
apiVersion: v1
kind: Pod
metadata:
name: mypod
spec:
containers:
- name: mycontainer
image: busybox
command: ["sh", "-c", "cat /config/redis.properties; sleep 3600"]
volumeMounts:
- name: config-volume
mountPath: /config
volumes:
- name: config-volume
configMap:
name: redis-config
```
2. 應用配置：
```bash
[root@k8smaster ~]# kubectl apply -f cm.yaml
pod/mypod created
```
3. 查看 Pod 狀態並檢查配置：
```bash
[root@k8smaster ~]# kubectl get pods
NAME READY STATUS RESTARTS AGE
mypod 1/1 Completed 0 41s
[root@k8smaster ~]# kubectl logs mypod
redis.host=127.0.0.1
redis.port=6379
redis.password=123456
```
---
#### **4. 以變量形式挂載到 Pod 容器中**
**步驟：**
1. 編寫 YAML 文件，將 ConfigMap 值作為環境變量注入：
```yaml
apiVersion: v1
kind: Pod
metadata:
name: mypod
spec:
containers:
- name: mycontainer
image: busybox
command: ["sh", "-c", "echo $REDIS_HOST; echo $REDIS_PORT; echo $REDIS_PASSWORD; sleep 3600"]
env:
- name: REDIS_HOST
valueFrom:
configMapKeyRef:
name: redis-config
key: redis.host
- name: REDIS_PORT
valueFrom:
configMapKeyRef:
name: redis-config
key: redis.port
- name: REDIS_PASSWORD
valueFrom:
configMapKeyRef:
name: redis-config
key: redis.password
```
2. 應用配置：
```bash
[root@k8smaster ~]# kubectl apply -f myconfig.yaml
pod/mypod created
```
3. 查看 Pod 狀態並檢查日誌：
```bash
[root@k8smaster ~]# kubectl logs mypod
127.0.0.1
6379
123456
```
---
### **小結**
- **Volume 挂載**：將 ConfigMap 文件直接映射到容器的文件系統中。
- **環境變量注入**：將 ConfigMap 的鍵值對作為環境變量傳遞給容器。
# K8s 安全機制
以下是圖片的文字辨識及繁體中文翻譯：
---
### **Kubernetes 集群安全機制**
[](https://bookstack.treemanou.com/uploads/images/gallery/2025-01/9Alz4LLG6GVwGnsM-image-1737341555160.png)
#### **1. 概述**
1. **訪問 k8s 集群時**，需要經過三個步驟完成具體操作：
- 第一步：認證
- 第二步：授權
- 第三步：準入控制
2. **訪問過程：**
- 訪問時需要經過 `apiserver`，`apiserver` 做統一認證和驗證，例如門衛。
- 訪問過程中需要 **證書**、**token**，或者用 **用戶名+密碼**。
- 如果訪問 Pod，還需要 **serviceAccount**。
---
#### **第一步 認證：傳輸安全**
- **傳輸安全：**
- 對外不暴露 8080 端口，只能內部訪問，對外使用端口 6443。
- **認證方式：**
- `https` 證書認證：基於 CA 證書。
- `http` token 認證：通過 token 識別用戶。
- `http` 基本認證：使用用戶名+密碼認證。
---
#### **第二步 授權：**
- 基於 RBAC 進行授權操作。
- 基於角色訪問控制。
---
#### **第三步 準入控制：**
- 準入控制器的列表，根據列表決定是否允許執行操作。
---
### **2. RBAC**
### **基於角色的訪問控制**
- **角色：**
- **role**：特定命名空間訪問權限
- **ClusterRole**：所有命名空間訪問權限
- **角色綁定：**
- **roleBinding**：角色綁定到主體
- **ClusterRoleBinding**：集群角色綁定到主體
---
### **主體：**
- **user**：用戶
- **group**：用戶組
- **serviceAccount**：服務帳號
---
這是基於 RBAC 的角色和權限管理，適用於 Kubernetes 的訪問控制。如需進一步說明或具體範例，請隨時告訴我！😊
[](https://bookstack.treemanou.com/uploads/images/gallery/2025-01/DdkVrwv0FBVX6fQ6-image-1737341811213.png)
以下是圖片中的文字辨識及翻譯成繁體中文：
---
### **1. 創建命名空間**
```bash
[root@m1 lucy]# kubectl create ns roledemo
namespace/roledemo created
```
---
### **2. 在新創建的命名空間中創建 Pod**
```bash
[root@m1]# kubectl run nginx --image=nginx -n roledemo
```
---
### **3. 創建角色**
```bash
[root@m1]# vi rbac-role.yaml
[root@m1]# kubectl apply -f rbac-role.yaml
role.rbac.authorization.k8s.io/pod-reader created
[root@m1]# kubectl get role -n roledemo
NAME AGE
pod-reader 19s
```
---
### **4. 創建角色綁定**
```bash
[root@m1]# vi rbac-rolebinding.yaml
[root@m1]# kubectl apply -f rbac-rolebinding.yaml
rolebinding.rbac.authorization.k8s.io/read-pods created
[root@m1]# kubectl get rolebinding -n roledemo
NAME AGE
read-pods 15s
```
---
### **5. 使用證書識別身份**
```bash
[root@m1 mary]# vi rbac-user.sh
[root@m1 mary]# cp /root/TLS/k8s/ca* ./
[root@m1 mary]# bash rbac-user.sh
2020/09/03 17:03:10 [INFO] generate received request
2020/09/03 17:03:10 [INFO] received CSR
[root@m1 mary]# kubectl get pods -n roledemo
```
---
### **說明：**
1. **命名空間** 用於區分不同的資源和工作負載。
2. **角色和角色綁定** 控制對特定命名空間的訪問權限。
3. **使用證書識別身份** 是基於 RBAC 的身份驗證機制，確保用戶能正確訪問資源。
# Ingress 概述
[](https://bookstack.treemanou.com/uploads/images/gallery/2025-01/k8k7s6z3OEy6PZa7-image-1737343343204.png)
---
## **Ingress**
### **1. 將端口號對外暴露，通過 IP + 端口號進行訪問**
- **使用 Service 裡面的 NodePort 實現**
---
### **2. NodePort 缺陷**
- **在每個節點上都會起到端口**，在訪問時可以通過任何節點，通過節點 IP + 暴露端口號實現訪問。
- 意味著每個端口只能使用一次，一個端口對應一個應用。
- **實際訪問中都是用域名**，根據不同域名跳轉到不同端口服務中。
---
### **3. Ingress 和 Pod 的關係d**
- **Pod 和 Ingress 是通過 Service 關聯的**。
- **Ingress 作為統一入口**，由 Service 關聯一組 Pod。
---
### **說明：**
- **Ingress** 提供基於域名的訪問路由能力，實現集群內外通信的靈活控制。
- 它比 NodePort 更靈活且節約端口資源，是 Kubernetes 中常用的負載均衡工具之一。
以下是圖片內容的文字辨識及翻譯成繁體中文：
---
## **5. 使用 Ingress**
- **第一步：** 部署 Ingress Controller
- **第二步：** 創建 Ingress 規則
---
我們在這裡選擇官方維護的 NGINX 控制器，實現部署。
---
以下是圖片中的文字辨識及翻譯成繁體中文：
---
## **6. 使用 Ingress 對外暴露應用**
### **(1) 創建 Nginx 應用，對外暴露端口使用 NodePort**
```bash
kubectl create deployment web --image=nginx
kubectl expose deployment web --port=80 --target-port=80 --type=NodePort
```
---
### **(2) 部署 Ingress Controller**
```bash
[root@k8smaster ~]# vi ingress-con.yaml
[root@k8smaster ~]# kubectl apply -f ingress-con.yaml
namespace/nginx-ingress created
configmap/nginx-configuration created
configmap/tcp-services created
configmap/udp-services created
serviceaccount/nginx-ingress-serviceaccount created
clusterrole.rbac.authorization.k8s.io/nginx-ingress-clusterrole created
role.rbac.authorization.k8s.io/nginx-ingress-role created
rolebinding.rbac.authorization.k8s.io/nginx-ingress-role-nisa-binding created
```
---
### **說明：**
1. **NodePort 暴露應用：**
- 通過 `NodePort` 將應用對外暴露，允許外部訪問特定端口。
2. **Ingress Controller 部署：**
- 使用配置文件 `ingress-con.yaml` 部署 Ingress 控制器，啟用基於域名的路由功能。
# helm 概述
[](https://bookstack.treemanou.com/uploads/images/gallery/2025-01/t6qsyMHUPkTrcAXu-image-1737350287413.png)
### **Helm**
#### **1. Helm 引入**
1. **之前方式部署應用的基本過程：**
- 編寫 YAML 文件：
- Deployment
- Service
- Ingress
2. **如果使用之前方式部署單一應用，少數服務的應用，比較合適：**
- 例如部署微服務項目，可能有幾十個服務，每個服務都有一套 YAML 文件，需要維護大量 YAML 文件，版本管理特別不方便。
---
#### **2. 使用 Helm 可以解決哪些問題？**
1. 使用 Helm 可以把這些 YAML 作為一個整體管理。
2. 實現 YAML 高效複用。
3. 使用 Helm 應用級別的版本管理。
---
#### **3. Helm 介紹**
Helm 是一個 Kubernetes 的包管理工具，類似於 Linux 下的包管理器，如 yum/apt 等，可以很方便地將之前打包好的 YAML 文件部署到 Kubernetes 上。
---
#### **4.Helm 有 3 個重要概念：**
1. **Helm**：
一個命令行客戶端工具，主要用於 Kubernetes 應用 Chart 的創建、打包、發布和管理。
2. **Chart**：
應用描述，一系列用於描述 Kubernetes 資源相關文件的集合。
3. **Release**：
基於 Chart 的部署實體。一個 Chart 被 Helm 運行後將會生成對應的一個 Release；
它會在 Kubernetes 中創建出真實運行的資源對象。
---
#### **5.Helm 在 2019 年發布 V3 版本，和之前版本相比有變化**
1. **V3 版本刪除 Tiller**，架構變化。
2. **Release** 可以在不同命名空間重用。
3. **將 Chart 推送到 Docker 倉庫中**。
---
以下是圖片內容的文字辨識及翻譯成繁體中文：
---
### **1. Helm 安裝**
1. **下載 Helm 安裝壓縮文件，上傳到 Linux 系統中**
```bash
[root@k8smaster ~]# tar zxvf helm-v3.0.0-linux-amd64.tar.gz
linux-amd64/helm
linux-amd64/README.md
linux-amd64/LICENSE
```
2. **解壓 Helm 壓縮文件，將解壓後的 Helm 目錄複製到 `/usr/bin` 目錄下**
```bash
[root@k8smaster linux-amd64]# mv helm /usr/bin
[root@k8smaster linux-amd64]# helm
```
---
### **2. 配置 Helm 倉庫**
#### **(1) 添加倉庫**
```bash
helm repo add 倉庫名稱 倉庫地址
```
示例：
```bash
[root@k8smaster linux-amd64]# helm repo add stable http://mirror.azure.cn/kubernetes/charts
"stable" has been added to your repositories
```
檢查倉庫列表：
```bash
[root@k8smaster linux-amd64]# helm repo list
NAME URL
stable http://mirror.azure.cn/kubernetes/charts
```
---
#### **(2) 更新倉庫地址**
```bash
[root@k8smaster linux-amd64]# helm repo update
Hang tight while we grab the latest from your chart repositories...
...Successfully got an update from the "aliyun" chart repository
...Successfully got an update from the "stable" chart repository
Update Complete. Happy Helming!
```
---
### **(3) 刪除倉庫**
```bash
[root@k8smaster linux-amd64]# helm repo remove aliyun
"aliyun" has been removed from your repositories
```
---
### **說明：**
- 使用 `helm repo remove <倉庫名稱>` 可以刪除已添加的 Helm 倉庫。
- 這樣可以清理不再需要的倉庫條目，保持倉庫列表整潔。
---
以下是圖片內容的文字辨識及翻譯成繁體中文：
---
```bash
[root@k8smaster linux-amd64]# helm search repo weave
NAME CHART VERSION APP VERSION DESCRIPTION
stable/weave-cloud 0.3.7 1.4.0 Weave Cloud is a add-on...
stable/weave-scope 1.1.10 1.12.0 A Helm chart for the We...
[root@k8smaster linux-amd64]# helm install ui stable/weave-scope
NAME: ui
LAST DEPLOYED: Mon Sep 7 14:22:47 2020
NAMESPACE: default
STATUS: deployed
[root@k8smaster linux-amd64]# helm list
NAME NAMESPACE REVISION UPDATED STATUS
ui default 1 2020-09-07 14:22:47.383427149 +0800 CST deployed
[root@k8smaster linux-amd64]# helm status ui
NAME: ui
LAST DEPLOYED: Mon Sep 7 14:22:47 2020
NAMESPACE: default
STATUS: deployed
REVISION: 1
```
---
1. **搜索 Helm 倉庫中的 Weave 應用**
- 使用命令 `helm search repo weave`，顯示兩個可用的應用：
- **stable/weave-cloud**：版本 0.3.7，應用版本 1.4.0。
- **stable/weave-scope**：版本 1.1.10，應用版本 1.12.0。
2. **安裝 Weave Scope**
- 使用命令 `helm install ui stable/weave-scope` 將 Weave Scope 安裝到 Kubernetes 中，並命名為 **ui**。
3. **查看已安裝的 Helm 應用列表**
- 使用命令 `helm list`，顯示應用 **ui** 已成功部署，位於命名空間 **default**。
4. **查看應用狀態**
- 使用命令 `helm status ui`，顯示應用名稱 **ui**，狀態為 **deployed**，部署版本為 **1**。
---
以下是圖片內容的文字辨識及翻譯成繁體中文：
---
### **如何自己創建 Chart**
#### **1. 使用命令創建 Chart**
```bash
helm create chart名稱
```
示例：
```bash
[root@k8smaster ~]# helm create mychart
Creating mychart
[root@k8smaster mychart]# ls
charts Chart.yaml templates values.yaml
```
- **Chart.yaml**：當前 Chart 屬性配置信息。
- **templates**：編寫 YAML 文件放到這個目錄中。
- **values.yaml**：YAML 文件可以使用全局變量。
---
#### **2. 在 templates 文件夾創建兩個 YAML 文件**
- **deployment.yaml**
- **service.yaml**
示例：
```bash
[root@k8smaster templates]# ls
deployment.yaml service.yaml
```
---
### **說明：**
1. **Helm create** 命令自動生成 Chart 的目錄結構和必要文件，方便進一步編輯。
2. **templates 文件夾** 是放置 Kubernetes 配置文件（如 Deployment、Service 等 YAML 文件）的地方。
3. **values.yaml** 文件允許定義變量，提供動態和靈活的配置支持。
---
以下是圖片內容的文字辨識及翻譯成繁體中文：
---
### **3. 安裝 mychart**
```bash
[root@k8smaster ~]# helm install web1 mychart/
NAME: web1
LAST DEPLOYED: Mon Sep 7 15:03:17 2020
NAMESPACE: default
STATUS: deployed
REVISION: 1
TEST SUITE: None
```
---
### **說明：**
1. **命令解釋**：
- `helm install`：用於安裝 Chart。
- `web1`：為此次安裝命名為 `web1`。
- `mychart/`：指定需要安裝的 Chart 目錄。
2. **輸出信息**：
- **NAME**：安裝的應用名稱，這裡是 `web1`。
- **LAST DEPLOYED**：最後部署的時間。
- **NAMESPACE**：部署的命名空間，默認為 `default`。
- **STATUS**：應用部署狀態，這裡是 `deployed`（已部署）。
- **REVISION**：部署的版本號，這裡是 `1`。
- **TEST SUITE**：測試套件信息，這裡是 `None`（沒有測試）。
---
### **4. 應用升級**
```bash
helm upgrade chart名稱
```
示例：
```bash
[root@k8smaster ~]# helm upgrade web1 mychart/
Release "web1" has been upgraded. Happy Helming!
```
---
### **說明：**
1. **命令解釋**：
- `helm upgrade`：用於升級已部署的 Chart 應用。
- `web1`：需要升級的應用名稱。
- `mychart/`：指定升級所基於的 Chart 目錄。
2. **輸出信息**：
- **Release "web1" has been upgraded**：表示應用 `web1` 已成功升級。
---
以下是圖片內容的文字辨識及翻譯成繁體中文：
---
### **實現 YAML 高效複用**
- **通過傳遞參數，動態渲染模板，YAML 內容動態傳入參數生成。**
```bash
[root@k8smaster mychart]# ls
charts Chart.yaml templates values.yaml
```
- **在 Chart 中有 `values.yaml` 文件，定義 YAML 文件全局變量。**
---
### **操作步驟：**
1. **在 `values.yaml` 定義變量和值。**
2. **在具體 YAML 文件中，獲取定義變量值。**
---
### **說明：**
- YAML 文件大體有幾個地方不同的參數：
- **image**
- **tag**
- **label**
- **port**
- **replicas**
---
### **說明：**
使用 `values.yaml` 提高了 Chart 的靈活性，可以輕鬆實現模板的複用和參數化，方便不同環境配置。
---
# k8s 持久化儲存
以下是圖片內容的文字辨識及翻譯成繁體中文：
---
### **數據卷 emptydir，是本地存儲，pod 重啟，數據不存在了，需要對數據持久化存儲**
#### **1. NFS，網絡存儲**
- **pod 重啟，數據還存在的方式**
---
### **第一步：找一台服務器作為 NFS 服務端**
#### **(1) 安裝 NFS**
```bash
yum install -y nfs-utils
```
---
#### **(2) 設置掛載路徑**
```bash
[root@atonline ntest /]# vi /etc/exports
/data/nfs *(rw,no_root_squash)
```
---
#### **(3) 掛載路徑需要創建出來**
```bash
[root@atonline ntest data]# mkdir nfs
[root@atonline ntest data]# ls
nfs
```
---
### **說明：**
1. **emptydir** 是 Kubernetes 中的一種臨時存儲方式，pod 重啟後數據會丟失。
2. **NFS（網絡文件系統）** 提供一種數據持久化存儲解決方案，pod 重啟後數據仍然保留。
3. **操作流程**：
- 安裝 NFS 軟件。
- 配置 NFS 的掛載路徑。
- 確保掛載的目錄已創建。
---
以下是圖片內容的文字辨識及翻譯成繁體中文：
---
### **第二步：在 k8s 集群 node 節點安裝 NFS**
```bash
yum install -y nfs-utils
```
---
### **說明：**
- 在 Kubernetes 集群的每個節點上安裝 **NFS 客戶端工具** (`nfs-utils`)，以便節點能夠掛載 NFS 共享存儲。
---
以下是圖片內容的文字辨識及翻譯成繁體中文：
---
### **第三步：在 NFS 服務器啟動 NFS 服務**
```bash
# systemctl start nfs
# ps -ef | grep nfs
15:03 ? 00:00:00 [nfsd4_callbacks]
```
---
### **第四步：在 k8s 集群部署應用使用 NFS 持久化網絡存儲**
```bash
vi nfs-nginx.yaml
kubectl apply -f nfs-nginx.yaml
[root@k8smaster pv]# kubectl exec -it nginx-depl-6b96bc8d7d-92qhv bash
kubectl exec [POD] [COMMAND] is DEPRECATED and will be removed in a future version.
root@nginx-depl-6b96bc8d7d-92qhv:/# ls /usr/share/nginx/html
index.html
```
---
### **說明：**
#### **第三步：啟動 NFS 服務**
1. **啟動 NFS 服務**：通過 `systemctl start nfs`。
2. **驗證 NFS 啟動狀態**：使用 `ps -ef | grep nfs` 查看進程是否正常啟動。
#### **第四步：部署應用並使用 NFS**
1. **編輯 YAML 文件**：創建或修改 `nfs-nginx.yaml` 文件，配置 NFS 為持久化存儲。
2. **應用配置文件**：使用 `kubectl apply` 部署應用。
3. **驗證 NFS 存儲是否生效**：
- 使用 `kubectl exec` 進入 Pod。
- 確認存儲目錄（如 `/usr/share/nginx/html`）內的文件是否存在，例如 `index.html`。
---
### **PV 和 PVC**
1. **PV（Persistent Volume，持久化存儲）：**
- 持久化存儲，對存儲資源進行抽象。
- 對外提供可調用的地方（生產者）。
2. **PVC（Persistent Volume Claim，持久化存儲請求）：**
- 用於調用，不需要關心內部實現細節（消費者）。
[](https://bookstack.treemanou.com/uploads/images/gallery/2025-01/osWVdYXoaoWBvta2-image-1737425386000.png)
# k8s 監控
### **集群資源監控**
### **1. 監控指標**
- **集群監控**
- 節點資源利用率
- 節點數量
- 運行的 Pods
- **Pod 監控**
- 容器指標
- 應用程序
---
### **2. 監控平台搭建方案：Prometheus + Grafana**
#### **(1) Prometheus**
- 開源的
- 具備監控、報警、數據庫功能
- 以 HTTP 協議定期抓取被監控組件的狀態
- 不需要複雜的集成過程，使用 HTTP 接口接入即可
---
#### **(2) Grafana**
- 開源的數據分析和可視化工具
- 支援多種數據源
[](https://bookstack.treemanou.com/uploads/images/gallery/2025-01/k2Kgei9VrKUtm41G-image-1737431399886.png)
```YAML
# rbac-setup.yaml
apiGroups: ["*"]
resources:
- nodes
- nodes/proxy
- services
- endpoints
- pods
verbs: ["get", "list", "watch"]
---
apiGroups:
- extensions
resources:
- ingresses
verbs: ["get", "list", "watch"]
nonResourceURLs: ["/metrics"]
verbs: ["get"]
---
apiVersion: v1
kind: ServiceAccount
metadata:
name: prometheus
namespace: kube-system
---
apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRoleBinding
metadata:
name: prometheus
roleRef:
apiGroup: rbac.authorization.k8s.io
kind: ClusterRole
name: prometheus
subjects:
- kind: ServiceAccount
name: prometheus
namespace: kube-system
```
# k8s 高可用集群
[](https://bookstack.treemanou.com/uploads/images/gallery/2025-01/IWsIsOcoqEizYTKK-image-1737445662276.png)
[](https://bookstack.treemanou.com/uploads/images/gallery/2025-01/g7khJjvP9vaPZrx8-image-1737445931517.png)
[](https://bookstack.treemanou.com/uploads/images/gallery/2025-01/FqBt277RZDlRMTfT-image-1737447248701.png)
# k8s 部署流程
[](https://bookstack.treemanou.com/uploads/images/gallery/2025-01/pIMK0hBwUkVbAUvB-image-1737453741721.png)
[](https://bookstack.treemanou.com/uploads/images/gallery/2025-01/E7Z2huIbJXOtAhJY-image-1737454023904.png)
```
FROM ubuntu:22.04
# 設定時區為台北
ENV TZ=Asia/Taipei
RUN apt-get update && apt-get install -y tzdata && \
ln -sf /usr/share/zoneinfo/$TZ /etc/localtime && \
echo $TZ > /etc/timezone && \
apt-get clean && \
rm -rf /var/lib/apt/lists/*
# 複製並執行安裝腳本
COPY install.sh /tmp/install.sh
RUN chmod +x /tmp/install.sh && /tmp/install.sh
```
# k8s核心組件
[](https://bookstack.treemanou.com/uploads/images/gallery/2025-01/VHfefOFyJ2w3ujxH-image-1737708797625.png)
[](https://bookstack.treemanou.com/uploads/images/gallery/2026-04/wGSVTF0PqNV9DXob-image-1775714710761.png)
**3. k8s 集群架構組件**
- **Master**（主控節點）和 **Node**（工作節點）
**(1) Master 組件**
- **apiserver**
集群統一入口，以 RESTful 方式，交給 etcd 存儲
- **scheduler**
節點調度，選擇 Node 節點應用部署
- **controller-manager**
處理集群中常規的後台任務，一個資源對應一個控制器
- **etcd**
存儲系統，用於保存集群相關的數據
**(2) Node 組件**
- **kubelet**
- Master 排到 Node 節點代表，管理本機容器。
- **kube-proxy**
- 提供網絡代理，負載均衡等操作。
[](https://bookstack.treemanou.com/uploads/images/gallery/2025-01/9yvSvsn0UIJSvrjb-image-1737710111332.png)
[](https://bookstack.treemanou.com/uploads/images/gallery/2025-01/xmcWqhFoJCkTOuXa-image-1737712398081.png)
---
**K8S 核心概念**
1. **Pod**
- 最小部署單元
- 一組容器的集合
- 共享網絡
- 生命週期是短暫的
2. **Controller**
- 確保預期的 Pod 副本數量
- 無狀態應用部署
- 有狀態應用部署
- 確保所有的 Node 運行同一個 Pod
- 一次性任務和定時任務
3. **Service**
- 定義一組 Pod 的訪問規則
---
如有其他需求，請隨時告訴我！
[](https://bookstack.treemanou.com/uploads/images/gallery/2025-01/nPoPBQnry7LR1o2F-image-1737708872912.png)
kubectl run podtest --image=nginx
1\. kubectl向apiserver發送一個創建pod的請求，apiserver會將數據放到etcd存儲。
2\. Scheduler通過list-watch的方式，收到未綁定pod資源，通過自身調度算法選擇一個合適的node進行綁定，然後響應給apiserver，把信息更新到etcd中。
3\. Kubelet同樣通過list-watch的方式，收到分配到自己節點上pod，調用docker api創建容器，然後將容器狀態響應給apiserver，同時，把容器的信息、事件及狀態也通過apiserver寫入到etcd中。
# 2026 k8s 需知
從 5 年前（2021年）的 K8s 基礎出發，系統性地梳理了 **2026 年現代化 Kubernetes 架構**的演進。
身為系統建設負責人與架構師，以下是整理的核心重點：
### 1. 基礎架構的根本變革
- **脫離 Docker：** K8s 已移除 Dockershim，底層運行環境轉為 **containerd/CRI-O**。
- **輕量化首選：** **K3s** (K8s/2) 成為主流，適合邊緣運算與本地測試。
- **工具鏈升級：** 建議在 Mac 使用 **OrbStack** 快速啟動 K3s；使用 **Kind** 模擬多節點生產環境。
- **遷移利器：** 使用 **Kompose** 將舊有的 `docker-compose.yaml` 轉換為 K8s 物件。
- **Gateway API 取代 Ingress：** 這是 2026 年最重要的標準。透過角色分離（GatewayClass, Gateway, HTTPRoute）解決權限與配置混亂問題。
- **Service 角色重新定義：**
- **ClusterIP：** 內部通訊基石，實現 Pod 間的備援與負載平衡。
- **NodePort：** 您的實體環境中，對接手動 SLB 的關鍵入口。
- **LoadBalancer：** 雲端自動化專用，在地端手動環境可被 NodePort 取代。
- **ExternalName：** 用於將叢集外部服務（如舊資料庫）內部化。
- **現代交警 Traefik：** K3s 內建，支援自動發現與 Gateway API，負責精準指揮 Traffic。
- **版本與權限控制：** 透過 **Label (v1/v2)** 區分版本，並利用 **HTTPRoute Weight** 實現金絲雀發佈或藍綠部署。
- **Service Mesh (服務網格)：** 如 Istio 或 Cilium，處理東西向流量的加密 (mTLS)、觀測與斷路保護。
- **YAML 物件現代化：** 建議在既有清單中加入 **StorageClass** (動態儲存)、**NetworkPolicy** (零信任安全) 與 **ServiceAccount** (權限管理)。
---
1. **本地實驗：** 在 **OrbStack** 啟動 K8s，將一個簡單服務從 `docker-compose` 透過 `kompose` 搬上去。
2. **網路重構：** 練習不寫 Ingress，直接用 **Gateway API + HTTPRoute** 透過 NodePort 對接您的實體 SLB。
3. **穩定性強化：** 試著部屬兩個版本的 Pod，並在 `HTTPRoute` 調整權重進行流量切分。
- **技術核心：** 內建基於 **K3s** 的輕量化叢集。
- **優勢：**
- **極速啟動：** 啟動 K8s 僅需約 2-5 秒。
- **低資源消耗：** 閒置時幾乎不佔 CPU，且 RAM 是動態分配的。
- **原生網路：** 支援直接透過 `.orb.local` 網域存取叢集內的 Service，不需要手動 `port-forward`。
- **適用場景：** 日常開發、快速測試 API 與微服務。
---
- **技術核心：** 將每個 K8s 節點跑在一個 Docker 容器內。
- **優勢：**
- **模擬多節點：** 透過一個 YAML 配置就能啟動 1 個 Master + N 個 Worker 節點。
- **CI/CD 友好：** 因為底層是 Docker，它可以在 GitLab Runner 或 GitHub Actions 中輕鬆執行。
- **Gateway API 測試：** 非常適合用來測試最新的 Gateway API 或 Service Mesh 配置。
- **適用場景：** 測試集群架構行為（如 Pod 親和性、節點故障轉移）。
---
- **優勢：** 繼承了 K3s 的快速與低資源特性，同時擁有 Kind 的多節點管理能力。
- **適用場景：** 需要模擬多節點但電腦資源（RAM）較為吃緊時。
---
**工具** **啟動速度** **資源佔用** **模擬多節點** **推薦等級 (2026)** **OrbStack** 極快 極低 較難 (內建單節點) ⭐⭐⭐⭐⭐ (Mac 首選) **Kind** 中等 中等 **極易** ⭐⭐⭐⭐ (架構測試首選) **K3d** 快 低 容易 ⭐⭐⭐⭐ (輕量首選) **Minikube** 慢 高 (需 VM) 普通 ⭐⭐ (已逐漸式微)
---
1. **安裝 OrbStack：** 作為您的 Docker 與基礎 K8s 環境，解決 90% 的開發需求。
2. **搭配 Kind：** 當您需要測試複雜的負載平衡、多節點調度或跨節點網路時，在 OrbStack 上跑 Kind 叢集。
```
apiVersion: apps/v1
kind: Deployment
metadata:
name: my-app-v1
spec:
replicas: 2
selector:
matchLabels:
app: my-app
version: v1
template:
metadata:
labels:
app: my-app
version: v1
spec:
containers:
- name: nginx
image: nginxdemos/hello:plain-text
ports:
- containerPort: 80
---
apiVersion: v1
kind: Service
metadata:
name: my-app-v1
spec:
selector:
app: my-app
version: v1
ports:
- protocol: TCP
port: 80
targetPort: 80
---
apiVersion: apps/v1
kind: Deployment
metadata:
name: my-app-v2
spec:
replicas: 2
selector:
matchLabels:
app: my-app
version: v2
template:
metadata:
labels:
app: my-app
version: v2
spec:
containers:
- name: nginx
image: nginxdemos/hello:plain-text
ports:
- containerPort: 80
---
apiVersion: v1
kind: Service
metadata:
name: my-app-v2
spec:
selector:
app: my-app
version: v2
ports:
- protocol: TCP
port: 80
targetPort: 80
```
---
```
kubectl apply -f https://github.com/kubernetes-sigs/gateway-api/releases/download/v1.0.0/standard-install.yaml
kubectl apply -f https://raw.githubusercontent.com/traefik/traefik/v3.0/docs/content/reference/dynamic-configuration/kubernetes-crd-definition-v1.yml
helm upgrade --install traefik traefik/traefik \
--namespace traefik --create-namespace \
--set ports.web.nodePort=30080 \
--set ports.web.port=8000 \
--set service.type=NodePort \
--set providers.kubernetesGateway.enabled=true \
--set additionalArguments="{--providers.kubernetesgateway,--entrypoints.web.address=:8000}" \
--skip-crds
```
```
kubectl apply -f apps.yaml
kubectl apply -f gateway-api.yml
```
---
```
kubectl get endpoints my-app-v1 my-app-v2
```
```
for i in {1..20}; do
curl -s -H "Host: localhost" http://localhost | grep "Server name"
done
```
---
1. **埠號對齊**：解決了 `Empty reply` 與 `PortUnavailable` 問題。
2. **所有權衝突**：透過重置 Gateway 與正確使用 Helm 參數規避了 `SSA Conflict`。
3. **命名空間授權**：透過 `from: All` 解決了跨 Namespace 404 的問題。
4. **內容識別**：修正了 `grep` 關鍵字，確保能從 Nginx 輸出中精確捕捉版本差異。
```
[PDOException]
SQLSTATE[42000]: Syntax error or access violation: 1071 Specified key was too long; max key length is 767 bytes
```
1. 更新到 MySQL 5.7.7 以上版本
2. 調整 Laravel 的預設資料長度
```
use Illuminate\Support\Facades\Schema;
```
```
public function boot()
{
Schema::defaultStringLength(191);
}
```
```
namespace App\Providers;
use Illuminate\Support\ServiceProvider;
use Illuminate\Support\Facades\Schema;
class AppServiceProvider extends ServiceProvider
{
/**
* Bootstrap any application services.
*
* @return void
*/
public function boot()
{
Schema::defaultStringLength(191);
}
/**
* Register any application services.
*
* @return void
*/
public function register()
{
//
}
}
```
# Laravel 解決在 CentOS 7 下 log 檔無法寫入的問題
在 `config/logging.php`
'permission' => 0775,
```JSON
'daily' => [
'driver' => 'daily',
'path' => storage_path('logs/laravel.log'),
'level' => 'debug',
'days' => 7,
'permission' => 0775,
],
```
---
在非 homestead 的主機上執行 laravel 時，有時會出現空白畫面，或是以下的錯誤訊息：
```
The stream or file "/xxxx/yyyy/zzzz/storage/logs/laravel-<日期>.log" could not be opened: failed to open stream: Permission denied
```
這是因為我們使用不同的方式執行 laravel 程式，會讓 log 檔有不同權限設定，和沒有檔案的寫入權限。
內容目錄
- [解法一：將 logS 目錄及檔案權限直接設為 777 (不推薦)](https://kirin.idv.tw/laravel-log-stream-open-failed-in-centos-7/#%E8%A7%A3%E6%B3%95%E4%B8%80%EF%BC%9A%E5%B0%87_logS_%E7%9B%AE%E9%8C%84%E5%8F%8A%E6%AA%94%E6%A1%88%E6%AC%8A%E9%99%90%E7%9B%B4%E6%8E%A5%E8%A8%AD%E7%82%BA_777_(%E4%B8%8D%E6%8E%A8%E8%96%A6) "解法一：將 logS 目錄及檔案權限直接設為 777 (不推薦)")
- [解法二：設計好適當的權限](https://kirin.idv.tw/laravel-log-stream-open-failed-in-centos-7/#%E8%A7%A3%E6%B3%95%E4%BA%8C%EF%BC%9A%E8%A8%AD%E8%A8%88%E5%A5%BD%E9%81%A9%E7%95%B6%E7%9A%84%E6%AC%8A%E9%99%90 "解法二：設計好適當的權限")
- [步驟一：設定群組權限](https://kirin.idv.tw/laravel-log-stream-open-failed-in-centos-7/#%E6%AD%A5%E9%A9%9F%E4%B8%80%EF%BC%9A%E8%A8%AD%E5%AE%9A%E7%BE%A4%E7%B5%84%E6%AC%8A%E9%99%90 "步驟一：設定群組權限")
- [步驟二：修改「網頁伺服器」的預設檔案存取權限](https://kirin.idv.tw/laravel-log-stream-open-failed-in-centos-7/#%E6%AD%A5%E9%A9%9F%E4%BA%8C%EF%BC%9A%E4%BF%AE%E6%94%B9%E3%80%8C%E7%B6%B2%E9%A0%81%E4%BC%BA%E6%9C%8D%E5%99%A8%E3%80%8D%E7%9A%84%E9%A0%90%E8%A8%AD%E6%AA%94%E6%A1%88%E5%AD%98%E5%8F%96%E6%AC%8A%E9%99%90 "步驟二：修改「網頁伺服器」的預設檔案存取權限")
- [步驟三、修改「命令列」的預設檔案存取權限](https://kirin.idv.tw/laravel-log-stream-open-failed-in-centos-7/#%E6%AD%A5%E9%A9%9F%E4%B8%89%E3%80%81%E4%BF%AE%E6%94%B9%E3%80%8C%E5%91%BD%E4%BB%A4%E5%88%97%E3%80%8D%E7%9A%84%E9%A0%90%E8%A8%AD%E6%AA%94%E6%A1%88%E5%AD%98%E5%8F%96%E6%AC%8A%E9%99%90 "步驟三、修改「命令列」的預設檔案存取權限")
- [步驟四、修改 「cron」 的預設檔案存取權限](https://kirin.idv.tw/laravel-log-stream-open-failed-in-centos-7/#%E6%AD%A5%E9%A9%9F%E5%9B%9B%E3%80%81%E4%BF%AE%E6%94%B9_%E3%80%8Ccron%E3%80%8D_%E7%9A%84%E9%A0%90%E8%A8%AD%E6%AA%94%E6%A1%88%E5%AD%98%E5%8F%96%E6%AC%8A%E9%99%90 "步驟四、修改 「cron」 的預設檔案存取權限")
- [解法二總結](https://kirin.idv.tw/laravel-log-stream-open-failed-in-centos-7/#%E8%A7%A3%E6%B3%95%E4%BA%8C%E7%B8%BD%E7%B5%90 "解法二總結")
- [參考資料](https://kirin.idv.tw/laravel-log-stream-open-failed-in-centos-7/#%E5%8F%83%E8%80%83%E8%B3%87%E6%96%99 "參考資料")
```php
chmod
- R
777 storage
/ logs
/
```
```bash
usermod -a -G apeche john
usermod -a -G john apache
```
```bash
mkdir /etc/systemd/system/httpd.service.d
vi /etc/systemd/system/httpd.service.d/umask.conf
systemctl daemon-reload
systemctl restart httpd.service
```
```bash
umask
umask 0002
vi ~/.bashrc
```
```bash
vi /usr/lib/systemd/system/crond.service
systemctl daemon-reload
systemctl restart crond.service
```
程式碼 說明 $table->id(); $table->bigIncrements('id') 的別名 $table->foreignId('user\_id'); $table->unsignedBigInteger('user\_id') 的別名 $table->bigIncrements('id'); 遞增 ID（主鍵），相當於「UNSIGNED BIG INTEGER」 $table->bigInteger('votes'); 相當於 BIGINT $table->binary('data'); 相當於 BLOB $table->boolean('confirmed'); 相當於 BOOLEAN $table->char('name', 100); 相當於帶有長度的 CHAR $table->date('created\_at'); 相當於 DATE $table->dateTime('created\_at', 0); 相當於 DATETIME ，可以指定位數 $table->dateTimeTz('created\_at', 0); 相當於 DATETIME (帶時區) ，可以指定位數 $table->decimal('amount', 8, 2); 相當於 DECIMAL，可以指定總位數和小數位數 $table->double('amount', 8, 2); 相當於 DOUBLE，可以指定總位數和小數位數 $table->enum('level', \['easy', 'hard'\]); 相當於 ENUM $table->float('amount', 8, 2); 相當於 FLOAT，可以指定總位數和小數位數 $table->geometry('positions'); 相當於 GEOMETRY $table->geometryCollection('positions'); 相當於 GEOMETRYCOLLECTION $table->increments('id'); 遞增 ID（主鍵），相當於 UNSIGNED INTEGER $table->integer('votes'); 相當於 INTEGER $table->ipAddress('visitor'); 相當於 IP 地址 $table->json('options'); 相當於 JSON $table->jsonb('options'); 相當於 JSONB $table->lineString('positions'); 相當於 LINESTRING $table->longText('description'); 相當於 LONGTEXT $table->macAddress('device'); 相當於 MAC 地址 $table->mediumIncrements('id'); 遞增 ID（主鍵），相當於 UNSIGNED MEDIUMINT $table->mediumInteger('votes'); 相當於 MEDIUMINT $table->mediumText('description'); 相當於 MEDIUMTEXT $table->morphs('taggable'); 相當於加入遞增 UNSIGNED BIGINT 類型的 taggable\_id 與字串類型的 taggable\_type $table->uuidMorphs('taggable'); 相當於添加一個 CHAR (36) 類型的 taggable\_id 欄位和 VARCHAR (255) UUID 類型的 taggable\_type $table->multiLineString('positions'); 相當於 MULTILINESTRING $table->multiPoint('positions'); 相當於 MULTIPOINT $table->multiPolygon('positions'); 相當於 MULTIPOLYGON $table->nullableMorphs('taggable'); 添加一個可以為空版本的 morphs() 欄位 $table->nullableUuidMorphs('taggable'); 添加一個可以為空版本的 uuidMorphs() 欄位 $table->nullableTimestamps(0); timestamps() 方法的別名 $table->point('position'); 相當於 POINT $table->polygon('positions'); 相當於 POLYGON $table->rememberToken(); 添加一個允許空值的 VARCHAR (100) 類型的 remember\_token 欄位 $table->set('flavors', \['strawberry', 'vanilla'\]); 相當於 SET $table->smallIncrements('id'); 遞增 ID（主鍵），相當於 UNSIGNED SMALLINT $table->smallInteger('votes'); 相當於 SMALLINT $table->softDeletes('deleted\_at', 0); 相當於為軟刪除添加一個可為空值的 deleted\_at 欄位 $table->softDeletesTz('deleted\_at', 0); 相當於為軟刪除添加一個可為空值的帶時區的 deleted\_at 欄位 $table->string('name', 100); 相當於指定長度的 VARCHAR $table->text('description'); 相當於 TEXT $table->time('sunrise', 0); 相當於指定位數的 TIME $table->timeTz('sunrise', 0); 相當於指定位數帶時區的 TIME $table->timestamp('added\_on', 0); 相當於指定位數的時間戳記 $table->timestampTz('added\_on', 0); 相當於指定位數帶時區的時間戳記 $table->timestamps(0); 相當於添加可為空值的時間戳記類型的 created\_at 和 updated\_at $table->timestampsTz(0); 相當於添加指定時區的可為空值的時間戳記類型的 created\_at 和 updated\_at $table->tinyIncrements('id'); 相當於自動遞增 UNSIGNED TINYINT $table->tinyInteger('votes'); 相當於 TINYINT $table->unsignedBigInteger('votes'); 相當於 UNSIGNED BIGINT $table->unsignedDecimal('amount', 8, 2); 相當於 UNSIGNED DECIMAL ，可以指定總位數和小數位數 $table->unsignedInteger('votes'); 相當於 UNSIGNED INTEGER $table->unsignedMediumInteger('votes'); 相當於 UNSIGNED MEDIUMINT $table->unsignedSmallInteger('votes'); 相當於 UNSIGNED SMALLINT $table->unsignedTinyInteger('votes'); 相當於 UNSIGNED TINYINT $table->uuid('id'); 相當於 UUID $table->year('birth\_year'); 相當於 YEAR
[學習Laravel Migration，看這一篇就夠了 (pandalab.org)](https://pandalab.org/articles/105)
# Laravel queue 使用supervisor 實現多執行序
[https://segmentfault.com/a/1190000021165798](https://segmentfault.com/a/1190000021165798)
```
[program:laravel-queue-work]
process_name=%(program_name)s_%(process_num)02d
directory=/data/yoursite
command=php artisan queue:work
autostart=true
autorestart=true
user=www
numprocs=32
redirect_stderr=true
```
安裝supervisor
```shell
yum install -y supervisor
```
修改設定檔 vim /etc/supervisord.conf
```INI
[include]
files = supervisord.d/*.conf
;files = supervisord.d/*.ini 改成 files = supervisord.d/*.conf
```
新增 laravel-queue-work.conf
```shell
vim /etc/supervisord.d/laravel-queue-work.conf
```
```
[program:laravel-queue-work]
process_name=%(program_name)s_%(process_num)02d
directory=/usr/share/nginx/html/laravel5/webmon
command=php artisan queue:work
autostart=true
autorestart=true
user=nginx
numprocs=50
;stdout_logfile = /etc/supervisor.d/log/laravel-queue.log
;stderr_logfile = /etc/supervisor.d/log/laravel-queue_err.log
redirect_stderr=true
[supervisord]
```
常用指令
```shell
#執行 supervisor
#supervisord
#supervisord -c /etc/supervisord.d/laravel-queue-work.conf (指令config)
[root@aaa]# supervisord
/usr/lib/python2.7/site-packages/supervisor/options.py:461: UserWarning: Supervisord is running as root and it is searching for its configuration file in default locations (including its current working directory); you probably want to specify a "-c" argument specifying an absolute path to a configuration file for improved security.
'Supervisord is running as root and it is searching '
#顯示執行 目前沒有執行
[root@a1-gcm12 etc]# supervisorctl status
unix:///var/run/supervisor/supervisor.sock no such file
#顯示執行 (目前執行)
[root@a1-gcm12 etc]# supervisorctl status
laravel-queue-work:laravel-queue-work_00 RUNNING pid 28389, uptime 0:00:20
laravel-queue-work:laravel-queue-work_01 RUNNING pid 28388, uptime 0:00:20
laravel-queue-work:laravel-queue-work_02 RUNNING pid 28391, uptime 0:00:20
#修改設定檔後重新載入
[root@a1-gcm12 etc]# supervisorctl reload
#停用 supervisor
[root@aaa]# supervisorctl shutdown
Shut down
```
# Laravel Repository
[Day13-\[Laravel 資料夾目錄與內容\] Repository - iT 邦幫忙::一起幫忙解決難題，拯救 IT 人的一天 (ithome.com.tw)](https://ithelp.ithome.com.tw/articles/10205996)
# Laravel_解決CORS錯誤
已封鎖跨來源請求: 同源政策不允許讀取 http://192.168.1.1/api/XXXXXX 的遠端資源。（原因: 缺少 CORS 'Access-Control-Allow-Origin' 檔頭）
建立 app/Http/Middleware/Cors.php
```PHP
header('Access-Control-Allow-Origin', '*')
->header('Access-Control-Allow-Methods', '*')
->header('Access-Control-Allow-Headers', 'Origin, Methods, Content-Type, Authorization')
->header('Access-Control-Allow-Credentials', true);
}
}
```
app/Http/Kenek.php
```PHP
protected $routeMiddleware = [
//加入
'cors' => \App\Http\Middleware\Cors::class,
];
protected $middlewarePriority = [
//加入
\App\Http\Middleware\Cors::class
];
```
路由加入middle ware
routes/api.php
```PHP
Route::group(['middleware' => 'cors'],function(){
Route::match(['get','post'],'test/TestApi','TestController@TestApi');
});
```
# Laravel_log_permission
config/logging.php
```PHP
'daily' => [
'driver' => 'daily',
'path' => storage_path('logs/laravel.log'),
'level' => 'debug',
'days' => 7,
'permission' => 0664,
],
```
參考：[Laravel daily log created with wrong permissions | Newbedev](https://newbedev.com/laravel-daily-log-created-with-wrong-permissions)
# Laravel_Queue
[20分鐘學會Laravel的Queue功能 (pandalab.org)](https://www.pandalab.org/articles/107)
修改設定檔 env.php -> 指定何種連接
queue.php 連接設定
[](https://bookstack.treemanou.com/uploads/images/gallery/2021-11/mL8DFlh054owdEE9-image-1637202514068.png)
[](https://bookstack.treemanou.com/uploads/images/gallery/2021-11/0ZD3mQBGlPv9OePm-image-1637202726195.png)
建立table
```shell
# 建立 jobs table
php artisan queue:table
# 建立 failed-table
php artisan queue:failed-table
# 執行建立工作
php artisan migrate
```
建立job
```shell
#php artisan make:job {job name}
php artisan make:job TestGcm
```
# Laravel_Request
參考：
[學習LARAVEL 請求，看這一篇就夠了 (pandalab.org)](https://pandalab.org/articles/108)
# Laravel_Validation
參考:
[Laravel Validation 經驗談. 如何確認 request body的參數是符合我們預期的？… | by Kidd Chan | K88D | Medium](https://medium.com/kidd88/laravel-validation-%E7%B6%93%E9%A9%97%E8%AB%87-108902f61d09)
[Laravel 台灣翻譯文件 | Laravel 道場 (laravel-dojo.com)](https://docs.laravel-dojo.com/laravel/5.5/validation)
# 【Larvel】 redirect() 與 redirect()->intended()
在 Laravel 中，`redirect()->intended('/login')` 和 `redirect('/login')` 有一些差異，主要是用於不同的用途和情境：
1. **`redirect()->intended('/login')`**：
- `intended()` 方法用於重定向到上一個受保護路由的預期 URL。這通常在使用中間件保護的路由中，當用戶未登入而被重定向到登入頁面時，用於指示登入成功後應該返回的路由。
- 當用戶在未登入狀態下訪問一個需要登入才能訪問的路由時，系統會記錄下該受保護路由的 URL。當用戶成功登入後，使用 `redirect()->intended('/login')` 將用戶重定向到該受保護路由的 URL，這樣可以提供更好的使用者體驗。
```
return redirect() ->'/login' );
```
2. **`redirect('/login')`**：
- `redirect('/login')` 簡單地將用戶重定向到指定的 URL，這個 URL 可以是任何您希望將用戶重定向到的地方，例如登入頁面或任何其他頁面。
```
return redirect ('/login' )
Welcome to DemoProject!
```
3. **建立 `resources/sass/app.scss`**（如果尚未建立）：
```bash
mkdir -p resources/sass
```
在 **`resources/sass/app.scss`** 中新增基本樣式：
```scss
body {
font-family: Arial, sans-serif;
background-color: #f8f9fa;
}
```
4. **建立 `resources/css/app.css`**（如果有純 CSS 檔案的需求）：
```css
/* app.css */
body {
margin: 0;
padding: 0;
box-sizing: border-box;
}
```
---
## ✅ **步驟 5：修改 Blade 模板**
將 **`resources/views/welcome.blade.php`** 修改為 **`resources/views/index.blade.php`**，內容如下：
```html
InsureNext
```
---
## ✅ **步驟 6：路由設定**
在 **`routes/web.php`** 中新增以下路由設定，將所有頁面導向 Vue 入口頁面：
```php
use Illuminate\Support\Facades\Route;
Route::get('/{any}', function () {
return view('index');
})->where('any', '.*');
```
---
## ✅ **步驟 7：編譯資源**
執行以下指令來編譯前端資源：
```bash
npm run dev
```
若要進行生產環境的編譯，執行：
```bash
npm run production
```
---
## ✅ **錯誤排除 1：Module not found: Error: Can't resolve 'app.scss'**
如果你遇到以下錯誤：
```bash
Module not found: Error: Can't resolve 'resources/sass/app.scss'
```
請確保已建立 **`resources/sass/app.scss`**，或者修改 **`webpack.mix.js`**，移除 `sass` 編譯：
```javascript
const mix = require('laravel-mix');
mix.js('resources/js/app.js', 'public/js')
.vue();
```
---
## ✅ **錯誤排除 2：Unable to locate Mix file: /css/app.css**
如果你遇到以下錯誤：
```bash
Unable to locate Mix file: /css/app.css
```
請依照以下步驟處理：
1. 確認資源已正確編譯：
```bash
npm run dev
```
2. 若問題仍未解決，清除 Laravel 快取：
```bash
php artisan config:clear
php artisan cache:clear
php artisan view:clear
```
3. 確認檔案 **`public/css/app.css`** 存在。如果不存在，執行以下指令重新建立檔案：
```bash
npm run dev
```
---
## ✅ **完成！**
現在你已經成功建置了一個 **Laravel 8 + Vue 3** 專案，專案名稱為 **InsureNext**。
Laravel 的路由設定已將所有頁面導向 **Vue 入口頁面**，並由 **Vue Router** 來處理前端頁面轉換。