k8s-stackdriver 项目使用教程

1. 项目目录结构及介绍

k8s-stackdriver/
├── archived/
│   ├── custom-metrics-stackdriver-adapter/
│   ├── event-exporter/
│   ├── fluentd-gcp-scaler/
│   ├── hack/
│   ├── kubelet-to-gcm/
│   └── prometheus-to-sd/
├── .gitignore
├── .travis.yml
├── CONTRIBUTING.md
├── LICENSE
└── README.md

目录结构介绍

• archived/: 包含多个子项目，这些项目是预安装在 Google Kubernetes Engine (GKE) 集群中的工具源码。

  • custom-metrics-stackdriver-adapter/: 自定义指标适配器，用于将自定义指标导出到 Stackdriver。
  • event-exporter/: 事件导出器，用于将 Kubernetes 事件导出到 Stackdriver。
  • fluentd-gcp-scaler/: Fluentd GCP 扩展器，用于扩展 Fluentd 的资源。
  • hack/: 包含一些辅助脚本和工具。
  • kubelet-to-gcm/: 将 Kubelet 指标导出到 Google Cloud Monitoring (GCM)。
  • prometheus-to-sd/: 将 Prometheus 指标导出到 Stackdriver。

• .gitignore: Git 忽略文件配置。

• .travis.yml: Travis CI 配置文件。

• CONTRIBUTING.md: 贡献指南。

• LICENSE: 项目许可证，采用 Apache-2.0 许可证。

• README.md: 项目介绍和使用说明。

2. 项目启动文件介绍

由于 k8s-stackdriver 项目主要包含的是预安装在 GKE 集群中的工具源码，因此没有统一的启动文件。每个子项目都有其独立的启动方式和配置。

例如，prometheus-to-sd 子项目的启动方式可能如下：

./prometheus-to-sd --stackdriver-prefix=custom.googleapis.com --whitelisted-metrics=metric1,metric2 --pod-id=$(POD_ID) --namespace-id=$(NAMESPACE)

3. 项目配置文件介绍

每个子项目都有其独立的配置文件。以下是一些常见的配置文件示例：

prometheus-to-sd 配置示例

apiVersion: v1
kind: ConfigMap
metadata:
  name: prometheus-to-sd-config
data:
  config.yaml: |
    stackdriver-prefix: custom.googleapis.com
    whitelisted-metrics: metric1,metric2

event-exporter 配置示例

apiVersion: v1
kind: ConfigMap
metadata:
  name: event-exporter-config
data:
  config.yaml: |
    stackdriver-project-id: your-project-id
    log-level: info

fluentd-gcp-scaler 配置示例

apiVersion: v1
kind: ConfigMap
metadata:
  name: fluentd-gcp-scaler-config
data:
  config.yaml: |
    scale-factor: 2
    resource-limits:
      cpu: "1"
      memory: "1Gi"

这些配置文件通常通过 Kubernetes ConfigMap 或 Secret 挂载到容器中，并在启动时加载。

总结

k8s-stackdriver 项目是一个包含多个子项目的集合，每个子项目都有其独立的启动和配置方式。通过了解每个子项目的目录结构和配置文件，可以更好地理解和使用这些工具。