Installing Application Load Balancer Gateway API for Managed Service for Kubernetes
The Gateway APIGatewayClass
, Gateway
, HTTPRoute
, and more.
In Managed Service for Kubernetes, the Gateway API launches Yandex Application Load Balancer and the required auxiliary resources when a Kubernetes user declares a Gateway
resource in a Managed Service for Kubernetes cluster.
Getting started
-
If you do not have the Yandex Cloud command line interface yet, install and initialize it.
The folder specified in the CLI profile is used by default. You can specify a different folder using the
--folder-name
or--folder-id
parameter. -
Create a service account required for the Gateway API.
-
alb.editor
: To create the required resources.vpc.publicAdmin
: To manage external connectivity.certificate-manager.admin
: To use certificates registered in Yandex Certificate Manager.compute.viewer
: To use Managed Service for Kubernetes cluster nodes in balancer target groups.
-
Create an authorized key and save it to a file named
key.json
:yc iam key create \ --service-account-name <name_of_service_account_for_Gateway_API> \ --output sa-key.json
Installation using Yandex Cloud Marketplace
- Go to the folder page and select Managed Service for Kubernetes.
- Click the name of the Managed Service for Kubernetes cluster you need and select the Marketplace
- Under Applications available for installation, select Gateway API and click Use.
- Configure the application:
- Namespace: Select a namespace or create a new one.
- Application name: Enter a name for the application.
- Folder ID: Select the folder to create load balancers in.
- Network ID: Select the cloud network to host the load balancers.
- Subnet ID 1, Subnet ID 2, Subnet ID 3: Select the subnets to host the load balancers.
- Service account key: Paste the contents of the
sa-key.json
file or create a new service account key.
- Click Install.
- Wait for the application to change its status to
Deployed
.
Installation using a Helm chart
-
Install Helm
v3.7.0 or higher. -
Install kubectl
and configure it to work with the created cluster. -
To install a Helm chart
with the Gateway API, run the command below:export HELM_EXPERIMENTAL_OCI=1 && \ helm pull oci://cr.yandex/yc-marketplace/yandex-cloud/gateway-api/gateway-api-helm/gateway-api \ --version 0.4.30 \ --untar && \ helm install \ --namespace <namespace> \ --create-namespace \ --set folderId='<folder_ID>' \ --set networkId='<cloud_network_ID>' \ --set subnetId='<subnet_ID>' \ --set-file saKeySecretKey='<sa-key.json_file_path>' \ gateway-api ./gateway-api/