行前準備
Elastic Observability 實作體驗營 @ DevOpsDays Taipei 2022
Last updated
Elastic Observability 實作體驗營 @ DevOpsDays Taipei 2022
Last updated
:::info 本頁面網址： https://hackmd.io/@estraining/DevOpsDaysTaipei2022 講者： Facebook 粉絲頁： :::
最少 16GB 以上的 RAM
最少 30GB 以上的 Disk Space
MacOS, Linux, Windows 皆可，但請不要用太舊的作業系統
:::danger 請注意，由於這次工作坊執行的 docker containers 數量眾多，記憶體的要求較高，如果記憶體不到 16GB 的話幾乎很難順利運作，若是要開雲端主機的話，可以參考 - 如果要使用雲端主機，可以設定-SSH-Tunnel-來存取 的設定方式。 :::
請先在電腦中安裝以下所需的執行環境：
Docker
Docker Compose ()
Python3 ()
Git (會簡單的 git clone, git pull, git checkout 即可。)
這次的工作坊，使用的是 Elastic 在 GitHub 所提供的 開源專案。
因為在操作時會需要 build Docker image 以及下載一些 Elastic Stack 的 Docker images，為了避免工作坊的時間被佔用在處理 build & download，建議請大家先完成以下的步驟。
取得 apm-integration-testing 的檔案。
準備好 Docker Images
有以下兩種選擇，自行 build 或是直接抓喬叔準備好的 docker images.
2-1. 自行 build: 在專案的根路徑下，執行以下 compose.py build 的指令，以建立及下載所需要使用到的 Docker images：
Mac or Linux：
Windows：
2-2. 直接使用喬叔 build 好的 docker image
Mac M1：
Linux：
Windows：
:::danger 其他平台需自行 build，否則 opbeans-go 和 opbeans-rum 會無法成功執行。 :::
確認 Docker Images 已被成功建置及下載。
使用 docker images 指令，確認有存在下列 Docker Images.
多確認是否能正常運作 Docker Cotainers
使用自行 build，請用：docker-compose up -d
若是使用另外的 yml 檔，請指定 -f 參數：docker-compose -f ./docker-compose-linux.yml up -d
請確認 containers 都能正常運作 (狀態為 healthy)，若有問題，可先參考 FAQ
composer.py 時 Docker build 出現 GPG errordocker 出現 GPG error: At least one invalid signature was encountered 相關問題及解決辦法。
There are a few reasons why you encounter these errors:
There might be an issue with the existing cache and/or disc space. In order to fix it you need to clear the APT cache by executing: sudo apt-get clean and sudo apt-get update.
The same goes with existing docker images. Execute: docker image prune -f and docker container prune -f in order to remove unused data and free disc space.
If you don’t care about the security risks, you can try to run the apt-get command with the --allow-unauthenticated or --allow-insecure-repositories flag. According to the docs:
Ignore if packages can’t be authenticated and don’t prompt about it. This can be useful while working with local repositories, but is a huge security risk if data authenticity isn’t ensured in another way by the user itself.
Finally, on MacOS, where Docker runs inside a dedicated VM, you may need to increase the disk available to Docker from the Docker Desktop application (Settings -> Resources -> Advanced -> Disk image size).
:::danger 執行以下指令會將你的 Docker 環境清空，包含 images, dangling build caches, containers，請確認後再操作。 :::
查看 docker-compose logs {container_name} 時，發現以下的錯誤：
這代表該 Docker Image 不是用對應的 platform 所建置，需自行 build imgae 才能使用。
unhealthy 的錯誤有可能是當下某一些有相依性的 service 還沒有正常的啟動，可以先重新使用 docker-compose 啟動一次試試，看看是否有改善。
若是依然有服務沒辦法正常啟動，可使用 docker ps -a 查看沒有正常啟動的服務是哪些，並進一步使用 docker logs {{DockerContainerName}} 查看錯誤訊息。
opbeans-dotnet 在 Apple M1 無法啟動使用 docker logs localtesting_8.4.1_opbeans-dotnet 查看，發現以下錯誤：
:::warning 在這次 Workshop 中，若是使用 Apple M1，我們先不啟用 opbeans-dotnet :::
先清除所有正在運作中的 containers，以下方式二擇一：
使用 composer.py
使用 docker-compose
如果有需要，可以一併刪除已產生的 docker volume.
~/.ssh/config 的參考設定如下：
以上述的例子，設定完成後，執行 ssh gcptunnel 即可將本機的 port 轉接到雲端主機。
:::danger 請注意，喬叔有特別為了這次工作坊進行一些準備，所以請直接到喬叔 fork 出來的 GitHub 專案進行下載 ，不要下載到 Elastic 官方版的哦！ :::
可使用 git clone 的指令，或是直接。
:::info 若遇到任何問題，歡迎透過 FB 粉絲頁 與我聯繫。 :::
