https://github.com/ytsaurus/ytsaurus-task-proxy

Task Proxy is a YTsaurus component for accessing web services deployed in operations.
https://github.com/ytsaurus/ytsaurus-task-proxy

Last synced: 3 months ago
JSON representation

Task Proxy is a YTsaurus component for accessing web services deployed in operations.

• Host: GitHub
• URL: https://github.com/ytsaurus/ytsaurus-task-proxy
• Owner: ytsaurus
• License: apache-2.0
• Created: 2026-01-19T14:38:42.000Z (6 months ago)
• Default Branch: main
• Last Pushed: 2026-03-19T14:06:10.000Z (4 months ago)
• Last Synced: 2026-03-20T06:48:52.550Z (4 months ago)
• Language: Go
• Homepage: https://ytsaurus.tech
• Size: 43.9 KB
• Stars: 3
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# YTsaurus Task proxy

YTsaurus operations often require deploying web services. These can be debugging UIs (such as Spark UI in [SPYT](https://ytsaurus.tech/docs/en/user-guide/data-processing/spyt/overview)), ML model inference servers, or APIs inside jobs.

Operation jobs run on cluster exec nodes, so services bind to network ports on these nodes — to receive incoming traffic. However, when attempting to directly access services inside a job, difficulties arise:

- Network isolation: the user may not have direct network access to exec node IP addresses (they may be in a closed perimeter).

- Dynamic addressing: even with network access, jobs can move between nodes, so the host and port of services constantly change.

- Security: direct access to a port on a node bypasses YTsaurus authentication mechanisms. Access control to the operation is not enforced.

_Task proxy_ solves these problems by providing a single entry point. It allocates stable domains (FQDN) for each service and verifies user access rights before redirecting the request inside the job.

For more information, refer to:

- [User docs](https://ytsaurus.tech/docs/user-guide/proxy/task) for usage examples,

- [Spark UI](https://ytsaurus.tech/docs/user-guide/data-processing/spyt/spark-ui) to learn how to open UI of [SPYT](https://ytsaurus.tech/docs/en/user-guide/data-processing/spyt/overview) clusters and jobs,

- [Admin docs](https://ytsaurus.tech/docs/admin-guide/install-task-proxy) for installation instructions.

## Development

Install chart to cluster from local directory using:

```sh

helm install task-proxy \

    -n ${NAMESPACE} \

    -f values.yaml \

    ./chart

```