diff --git a/charts/dependency/promtail/CHANGELOG.md b/charts/dependency/promtail/CHANGELOG.md index a3eb5dbc601..f66aa3ad82f 100644 --- a/charts/dependency/promtail/CHANGELOG.md +++ b/charts/dependency/promtail/CHANGELOG.md @@ -1,6 +1,15 @@ # Changelog
+ +### [promtail-1.0.0](https://github.com/truecharts/apps/compare/promtail-0.0.4...promtail-1.0.0) (2021-11-24) + +#### Chore + +* move promtail to dependency train + + + ### [promtail-0.0.4](https://github.com/truecharts/apps/compare/promtail-0.0.3...promtail-0.0.4) (2021-11-24) diff --git a/docs/apps/dependency/promtail/CHANGELOG.md b/docs/apps/dependency/promtail/CHANGELOG.md new file mode 100644 index 00000000000..f66aa3ad82f --- /dev/null +++ b/docs/apps/dependency/promtail/CHANGELOG.md @@ -0,0 +1,45 @@ +# Changelog
+ + + +### [promtail-1.0.0](https://github.com/truecharts/apps/compare/promtail-0.0.4...promtail-1.0.0) (2021-11-24) + +#### Chore + +* move promtail to dependency train + + + + +### [promtail-0.0.4](https://github.com/truecharts/apps/compare/promtail-0.0.3...promtail-0.0.4) (2021-11-24) + +#### Fix + +* fix storage issues with promtail + + + + +### [promtail-0.0.3](https://github.com/truecharts/apps/compare/promtail-0.0.2...promtail-0.0.3) (2021-11-24) + +#### Fix + +* correct mistake in namespace generator + + + + +### [promtail-0.0.2](https://github.com/truecharts/apps/compare/promtail-0.0.1...promtail-0.0.2) (2021-11-24) + +#### Fix + +* use actual namespace on promtail + + + + +### promtail-0.0.1 (2021-11-24) + +#### Add + +* add our own promtail dependency App ([#1394](https://github.com/truecharts/apps/issues/1394)) diff --git a/docs/apps/dependency/promtail/CONFIG.md b/docs/apps/dependency/promtail/CONFIG.md new file mode 100644 index 00000000000..fc9b2fa2d5f --- /dev/null +++ b/docs/apps/dependency/promtail/CONFIG.md @@ -0,0 +1,8 @@ +# Configuration Options + +##### Connecting to other apps +If you need to connect this App to other Apps on TrueNAS SCALE, please refer to our "Linking Apps Internally" quick-start guide: +https://truecharts.org/manual/Quick-Start%20Guides/14-linking-apps/ + +##### Available config options +In the future this page is going to contain an automated list of options available in the installation/edit UI. diff --git a/docs/apps/dependency/promtail/helm-values.md b/docs/apps/dependency/promtail/helm-values.md new file mode 100644 index 00000000000..7e7a9d16290 --- /dev/null +++ b/docs/apps/dependency/promtail/helm-values.md @@ -0,0 +1,63 @@ +# Default Helm-Values + +TrueCharts is primarily build to supply TrueNAS SCALE Apps. +However, we also supply all Apps as standard Helm-Charts. In this document we aim to document the default values in our values.yaml file. + +Most of our Apps also consume our "common" Helm Chart. +If this is the case, this means that all values.yaml values are set to the common chart values.yaml by default. This values.yaml file will only contain values that deviate from the common chart. +You will, however, be able to use all values referenced in the common chart here, besides the values listed in this document. + +## Values + +| Key | Type | Default | Description | +|-----|------|---------|-------------| +| args[0] | string | `"-config.file=/etc/promtail/promtail.yaml"` | | +| config | object | See `values.yaml` | Section for crafting Promtails config file. The only directly relevant value is `config.file` which is a templated string that references the other values and snippets below this key. | +| config.file | string | See `values.yaml` | Config file contents for Promtail. Must be configured as string. It is templated so it can be assembled from reusable snippets in order to avoid redundancy. | +| config.logLevel | string | `"info"` | The log level of the Promtail server Must be reference in `config.file` to configure `server.log_level` See default config in `values.yaml` | +| config.lokiAddress | string | `""` | The Loki address to post logs to. Must be reference in `config.file` to configure `client.url`. See default config in `values.yaml` | +| config.serverPort | int | `3101` | The port of the Promtail server Must be reference in `config.file` to configure `server.http_listen_port` See default config in `values.yaml` | +| config.snippets | object | See `values.yaml` | A section of reusable snippets that can be reference in `config.file`. Custom snippets may be added in order to reduce redundancy. This is especially helpful when multiple `kubernetes_sd_configs` are use which usually have large parts in common. | +| config.snippets.extraClientConfigs | string | empty | You can put here any keys that will be directly added to the config file's 'client' block. | +| config.snippets.extraRelabelConfigs | list | `[]` | You can put here any additional relabel_configs to "kubernetes-pods" job | +| config.snippets.extraScrapeConfigs | string | empty | You can put here any additional scrape configs you want to add to the config file. | +| envValueFrom.HOSTNAME.fieldRef.fieldPath | string | `"spec.nodeName"` | | +| image.repository | string | `"grafana/promtail"` | | +| image.tag | string | `"v2.3.0@sha256:1e8554cdac6681f877d10a2a383d8fcc2f475188914282ccf86722c2e23c501c"` | | +| persistence.config.enabled | bool | `true` | | +| persistence.config.mountPath | string | `"/etc/promtail"` | | +| persistence.config.objectName | string | `"promtail-config"` | | +| persistence.config.type | string | `"secret"` | | +| persistence.containers.enabled | bool | `true` | | +| persistence.containers.hostPath | string | `"/mnt"` | | +| persistence.containers.mountPath | string | `"/mnt"` | | +| persistence.containers.readOnly | bool | `true` | | +| persistence.containers.type | string | `"hostPath"` | | +| persistence.pods.enabled | bool | `true` | | +| persistence.pods.hostPath | string | `"/var/log/pods"` | | +| persistence.pods.mountPath | string | `"/var/log/pods"` | | +| persistence.pods.readOnly | bool | `true` | | +| persistence.pods.type | string | `"hostPath"` | | +| persistence.run.enabled | bool | `true` | | +| persistence.run.hostPath | string | `"/run/promtai"` | | +| persistence.run.mountPath | string | `"/run/promtail"` | | +| persistence.run.type | string | `"hostPath"` | | +| podSecurityContext | object | `{"runAsGroup":0,"runAsUser":0}` | The security context for pods | +| probes.liveness.path | string | `"/ready"` | | +| probes.readiness.path | string | `"/ready"` | | +| probes.startup.path | string | `"/ready"` | | +| rbac | object | `{"enabled":true,"rules":[{"apiGroups":[""],"resources":["nodes","nodes/proxy","services","endpoints","pods"],"verbs":["get","watch","list"]}]}` | Whether Role Based Access Control objects like roles and rolebindings should be created | +| securityContext | object | `{"allowPrivilegeEscalation":false,"capabilities":{"drop":["ALL"]},"readOnlyRootFilesystem":true,"runAsNonRoot":false}` | The security context for containers | +| service.main.ports.main.port | int | `3101` | | +| service.main.ports.main.targetPort | int | `3101` | | +| serviceAccount.create | bool | `true` | Specifies whether a ServiceAccount should be created | +| serviceMonitor.annotations | object | `{}` | ServiceMonitor annotations | +| serviceMonitor.enabled | bool | `false` | If enabled, ServiceMonitor resources for Prometheus Operator are created | +| serviceMonitor.interval | string | `nil` | ServiceMonitor scrape interval | +| serviceMonitor.labels | object | `{}` | Additional ServiceMonitor labels | +| serviceMonitor.namespace | string | `nil` | Alternative namespace for ServiceMonitor resources | +| serviceMonitor.namespaceSelector | object | `{}` | Namespace selector for ServiceMonitor resources | +| serviceMonitor.scrapeTimeout | string | `nil` | ServiceMonitor scrape timeout in Go duration format (e.g. 15s) | +| tolerations | list | `[{"effect":"NoSchedule","key":"node-role.kubernetes.io/master","operator":"Exists"},{"effect":"NoSchedule","key":"node-role.kubernetes.io/control-plane","operator":"Exists"}]` | Tolerations for pods. By default, pods will be scheduled on master/control-plane nodes. | + +All Rights Reserved - The TrueCharts Project diff --git a/docs/apps/dependency/promtail/index.md b/docs/apps/dependency/promtail/index.md new file mode 100644 index 00000000000..b74c9807de8 --- /dev/null +++ b/docs/apps/dependency/promtail/index.md @@ -0,0 +1,39 @@ +# Introduction + +Promtail is an agent which ships the contents of local logs to a Loki instance + +TrueCharts are designed to be installed as TrueNAS SCALE app only. We can not guarantee this charts works as a stand-alone helm installation. +**This chart is not maintained by the upstream project and any issues with the chart should be raised [here](https://github.com/truecharts/apps/issues/new/choose)** + +## Source Code + +* +* +* + +## Requirements + +Kubernetes: `>=1.16.0-0` + +## Dependencies + +| Repository | Name | Version | +|------------|------|---------| +| https://truecharts.org | common | 8.9.3 | + +## Installing the Chart + +To install this App on TrueNAS SCALE check our [Quick-Start Guide](https://truecharts.org/manual/Quick-Start%20Guides/03-Installing-an-App/). + +## Uninstalling the Chart + +To remove this App from TrueNAS SCALE check our [Quick-Start Guide](https://truecharts.org/manual/Quick-Start%20Guides/07-Deleting-an-App/). + +## Support + +- Please check our [quick-start guides](https://truecharts.org/manual/Quick-Start%20Guides/01-Open-Apps/) first. +- See the [Wiki](https://truecharts.org) +- Check our [Discord](https://discord.gg/tVsPTHWTtr) +- Open a [issue](https://github.com/truecharts/apps/issues/new/choose) +--- +All Rights Reserved - The TrueCharts Project diff --git a/docs/index.yaml b/docs/index.yaml index c6e9aa4d314..23dda189b8b 100644 --- a/docs/index.yaml +++ b/docs/index.yaml @@ -177475,6 +177475,41 @@ entries: - https://github.com/truecharts/apps/releases/download/prometheus-0.0.1/prometheus-0.0.1.tgz version: 0.0.1 promtail: + - annotations: + truecharts.org/SCALE-support: "true" + truecharts.org/catagories: | + - metrics + - logs + truecharts.org/grade: U + apiVersion: v2 + appVersion: 2.3.0 + created: "2021-11-24T19:52:09.662404427Z" + dependencies: + - name: common + repository: https://truecharts.org + version: 8.9.3 + description: Promtail is an agent which ships the contents of local logs to a + Loki instance + digest: e78a840a458cb0571a5c851ca99680bca516b001d6aaaf873f19e401a405d989 + home: https://github.com/truecharts/apps/tree/master/charts/stable/prometheus + icon: https://raw.githubusercontent.com/grafana/loki/master/docs/sources/logo.png + keywords: + - metrics + - logs + kubeVersion: '>=1.16.0-0' + maintainers: + - email: info@truecharts.org + name: TrueCharts + url: https://truecharts.org + name: promtail + sources: + - https://github.com/grafana/loki + - https://grafana.com/oss/loki/ + - https://grafana.com/docs/loki/latest/ + type: application + urls: + - https://github.com/truecharts/apps/releases/download/promtail-1.0.0/promtail-1.0.0.tgz + version: 1.0.0 - annotations: truecharts.org/SCALE-support: "true" truecharts.org/catagories: | @@ -251050,4 +251085,4 @@ entries: urls: - https://github.com/truecharts/apps/releases/download/zwavejs2mqtt-3.1.5/zwavejs2mqtt-3.1.5.tgz version: 3.1.5 -generated: "2021-11-24T19:29:00.666453033Z" +generated: "2021-11-24T19:52:09.752324449Z"