api-server

command
v1.119.1 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jun 18, 2026 License: MIT Imports: 35 Imported by: 0

README

Radix API Server

The Radix API Server is an HTTP server for accessing functionality on the Radix platform. This document is for Radix developers, or anyone interested in poking around.

Purpose

The Radix API is meant to be the single point of entry for platform users to the platform (through e.g. the Web Console). Users should not be able to access the Kubernetes API directly; therefore the Radix API limits and customises what platform users are able to do.

Security

Authentication and authorisation are performed through an HTTP bearer token, which is relayed to the Kubernetes API. The Kubernetes AAD integration then performs its authentication and resource authorisation checks, and the result is relayed to the user.

Running locally

The following env vars are needed. Useful default values in brackets.

  • RADIX_CONTAINER_REGISTRY - (radixdev.azurecr.io)

  • PROMETHEUS_URL - http://localhost:9091 use this to get Prometheus metrics running the following command (the local port 9090 is used by the API server /metrics endpoint, in-cluster URL is http://prometheus-operator-prometheus.monitor.svc.cluster.local:9090):

    kubectl -n monitor port-forward svc/prometheus-operator-prometheus 9091:9090
    

If you are using VSCode, there is a convenient launch configuration in .vscode.

Documentation

The Go Gopher

There is no documentation for this package.

Directories

Path Synopsis
api
deployments/mock
Package mock is a generated GoMock package.
Package mock is a generated GoMock package.
environments/mock
Package mock is a generated GoMock package.
Package mock is a generated GoMock package.
environmentvariables
Package environmentvariables is a generated GoMock package.
Package environmentvariables is a generated GoMock package.
events/mock
Package mock is a generated GoMock package.
Package mock is a generated GoMock package.
metrics/mock
Package mock is a generated GoMock package.
Package mock is a generated GoMock package.
metrics/prometheus/mock
Package mock is a generated GoMock package.
Package mock is a generated GoMock package.
secrets/suffix
file deepcode ignore HardcodedPassword: does not contain a secret value
file deepcode ignore HardcodedPassword: does not contain a secret value
test/mock
Package mock is a generated GoMock package.
Package mock is a generated GoMock package.
utils/tlsvalidation/mock
Package mock is a generated GoMock package.
Package mock is a generated GoMock package.
utils/token/mock
Package mock is a generated GoMock package.
Package mock is a generated GoMock package.
Package docs classification Radix API.
Package docs classification Radix API.
internal

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL