k8s叢集自動產生採集配置 - Simple Log Service

內建CRD（custom resource definition）模板工具內建了一系列採集能力，通過此工具，可以快速整合標準化採集能力並通過CRD管理採集配置的生命週期，避免控制台配置繁瑣步驟。

前提條件

採集Kubernetes叢集內Logs、Metrics、Trace資料，需要先安裝Logtail組件。Logtail組件安裝方式請參見：

安裝Logtail組件（阿里雲Kubernetes叢集）。
支援的Logtail組件版本： 1.7.3版本及以上，查看Logtail版本，請參見查看Logtail版本，升級Logtail版本，請參見升級Logtail。
安裝Logtail組件（自建Kubernetes叢集）。
支援的Logtail組件版本：V2及以上，查看Logtail版本，請參見查看Logtail版本，升級Logtail版本，請參見升級Logtail。

操作方式	描述
叢集外安裝	叢集外部安裝要求登入賬戶存在`~/.kube/config`設定檔（可以使用kubectl命令），且設定檔具有目的地組群操作許可權。
叢集內安裝	容器內安裝基於已安裝組件`alibaba-log-controller`許可權操作CRD 建立，適用於無`~/.kube/config`設定檔或網路問題無法串連時進行操作。

登入叢集，下載模板工具。

中國地區

curl https://logtail-release-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/kubernetes/crd-tool.tar.gz -o /tmp/crd-tool.tar.gz

海外地區

curl https://logtail-release-ap-southeast-1.oss-ap-southeast-1.aliyuncs.com/kubernetes/crd-tool.tar.gz -o /tmp/crd-tool.tar.gz

安裝模板工具，安裝成功後會在當前檔案夾產生sls-crd-tool工具。

tar -xvf /tmp/crd-tool.tar.gz -C /tmp &&chmod 755 /tmp/crd-tool/install.sh  && sh -x  /tmp/crd-tool/install.sh

登入叢集，進入alibaba-log-controller容器。

kubectl get pods -n kube-system -o wide |grep alibaba-log-controller | awk -F ' ' '{print $1}'
kubectl exec -it {pod} -n kube-system bash
cd ~

安裝模板工具，安裝成功後會在當前檔案夾產生sls-crd-tool工具。

tar -xvf /tmp/crd-tool.tar.gz -C /tmp &&chmod 755 /tmp/crd-tool/install.sh  && sh -x  /tmp/crd-tool/install.sh

./sls-crd-tool <全域參數> <操作指令> <指令參數>

參數	功能
--version或-v	查看工具版本。
--help或-h	查看工具協助文檔。
--kubepath path或-k path	指定kube config地址，僅叢集外操作生效，預設參數為 `~/.kube/config`。
--inner或-i	叢集內操作為在組件alibaba-log-controlle的容器內操作（此容器具有操作aliyunlogconfigs CRD的許可權）。如果無機器存在kube config操作許可權，推薦容器內安裝並操作。預設參數為false。
--language language或-l language	支援zh（中文）或en（英文）參數，預設參數為zh。

get

功能：下載模板配置, 模板設定檔將儲存為template-<NAME.yaml>檔案。
指令：
```
./sls-crd-tool get
```
指令參數：
- --help或-h：查看當前指令文檔。
- --gen或-g：產生模板檔案，預設參數為true。
- --output value或-o value輸出檔案格式，支援JSON和yaml，預設參數為yaml。

範例：

修改模板設定檔，請參考下表：

可修改的模板參數分為2種，如下所述，REQUIRED欄位為必要欄位，auto欄位可以按實際需求修改。

參數類型	說明
auto	支援自動填滿，具體填充參數為安裝指令時設定，目前支援自動填滿的值：ClusterID、MachineGroup、NameSpace、Project。重要 MachineGroup請保持auto 參數，模板會自動根據工作模型自動選擇正確機器組，避免因錯誤機器組導致的採集重複等問題。
REQUIRED	REQUIRED 參數為當前CRD 模板必須填寫的參數，請配置為使用情境參數值。