docs/deployment/schedulers/kubernetes.md

# Kubernetes Scheduler

> [!WARNING]
> Deprecation notice: This scheduler has been replaced with the [k3s scheduler plugin](/docs/deployment/schedulers/k3s.md) and is no longer under active development.

The [Kubernetes Scheduler Plugin](https://github.com/dokku/dokku-scheduler-kubernetes) is available free as an external plugin. Please see the plugin's [issue tracker](https://github.com/dokku/dokku-scheduler-kubernetes/issues) for more information on the status of the plugin.

For users that require additional functionality, please refer to the [Sponsoring Documentation](https://github.com/dokku/.github/blob/master/SPONSORING.md).

## Scheduler Interface

The following sections describe implemented scheduler functionality for the `kubernetes` scheduler.

### Implemented Commands and Triggers

This plugin implements various functionality through `plugn` triggers to integrate with `kubectl` for running apps on a Kubernetes cluster. The following functionality is supported by the `scheduler-kubernetes` plugin.

- `apps:destroy`
- `deploy`: partial, does not implement failed deploy log capture
- `logs`: partial, does not implement failure logs
- `ps:stop`

### Logging support

App logs for the `logs` command are fetched from running pods via the `kubectl` cli. To persist logs across deployments, consider using [Vector](https://vector.dev/docs/setup/installation/platforms/kubernetes/) or a similar tool to ship logs to another service or a third-party platform.
docs: clarify what is necessary for implementing a scheduler plugin Also split out kubernetes and nomad scheduler docs into their own pages. 2021-10-10 01:58:39 -04:00			`# Kubernetes Scheduler`

docs: use github admonitions These still need to be properly parsed. 2023-08-19 14:24:12 -04:00			`> [!WARNING]`
Note that the external kubernetes plugin is deprecated This was never in the core and thus doesn't need to be called out. 2024-01-23 11:11:35 -05:00			`> Deprecation notice: This scheduler has been replaced with the [k3s scheduler plugin](/docs/deployment/schedulers/k3s.md) and is no longer under active development.`
docs: clarify what is necessary for implementing a scheduler plugin Also split out kubernetes and nomad scheduler docs into their own pages. 2021-10-10 01:58:39 -04:00
docs: fix typo in kubernetes docs 2022-08-10 18:26:27 +00:00			`The [Kubernetes Scheduler Plugin](https://github.com/dokku/dokku-scheduler-kubernetes) is available free as an external plugin. Please see the plugin's [issue tracker](https://github.com/dokku/dokku-scheduler-kubernetes/issues) for more information on the status of the plugin.`
docs: clarify log shipping stance While it is unfortunate that we don't store logs locally, doing so is actually a fairly difficult ask. Rather than pretending the problem doesn't exist, we'll clarify how logs are currently fetched, as well as point users to integrations/tools that may make their lives easier. Refs #5234 2022-07-05 14:49:21 -04:00
			`For users that require additional functionality, please refer to the [Sponsoring Documentation](https://github.com/dokku/.github/blob/master/SPONSORING.md).`

			`## Scheduler Interface`

docs: fix reference to scheduler name in kubernetes docs Closes dokku/dokku-scheduler-kubernetes#40 2022-12-07 23:25:05 -05:00			The following sections describe implemented scheduler functionality for the `kubernetes` scheduler.
docs: clarify log shipping stance While it is unfortunate that we don't store logs locally, doing so is actually a fairly difficult ask. Rather than pretending the problem doesn't exist, we'll clarify how logs are currently fetched, as well as point users to integrations/tools that may make their lives easier. Refs #5234 2022-07-05 14:49:21 -04:00
			`### Implemented Commands and Triggers`

			This plugin implements various functionality through `plugn` triggers to integrate with `kubectl` for running apps on a Kubernetes cluster. The following functionality is supported by the `scheduler-kubernetes` plugin.
docs: clarify what is necessary for implementing a scheduler plugin Also split out kubernetes and nomad scheduler docs into their own pages. 2021-10-10 01:58:39 -04:00
			- `apps:destroy`
			- `deploy`: partial, does not implement failed deploy log capture
			- `logs`: partial, does not implement failure logs
			- `ps:stop`

docs: clarify log shipping stance While it is unfortunate that we don't store logs locally, doing so is actually a fairly difficult ask. Rather than pretending the problem doesn't exist, we'll clarify how logs are currently fetched, as well as point users to integrations/tools that may make their lives easier. Refs #5234 2022-07-05 14:49:21 -04:00			`### Logging support`
docs: clarify what is necessary for implementing a scheduler plugin Also split out kubernetes and nomad scheduler docs into their own pages. 2021-10-10 01:58:39 -04:00
docs: clarify log shipping stance While it is unfortunate that we don't store logs locally, doing so is actually a fairly difficult ask. Rather than pretending the problem doesn't exist, we'll clarify how logs are currently fetched, as well as point users to integrations/tools that may make their lives easier. Refs #5234 2022-07-05 14:49:21 -04:00			App logs for the `logs` command are fetched from running pods via the `kubectl` cli. To persist logs across deployments, consider using [Vector](https://vector.dev/docs/setup/installation/platforms/kubernetes/) or a similar tool to ship logs to another service or a third-party platform.