Edit Service External Access Settings

Time updated：2025-12-22 09:26:17

This section describes how to edit the service external access settings.

Note
This operation is only supported for services with the internal access mode set to VirtualIP. It is not supported for services with the internal access modes Headless or ExternalName.

Note

This operation is only supported for services with the internal access mode set to VirtualIP. It is not supported for services with the internal access modes Headless or ExternalName.

Prerequisites

The Application Management for Cluster Federation extension must be installed and enabled on the KubeSphere platform.
You need to join a federated project and have the Federated Project Management permission in the corresponding workspace.

Steps

Log in to the KubeSphere web console as a user with Federated Project Management permissions and enter your federated project.
Click Application Workloads > Services in the left navigation pane.
In the service list, click the name of a service to open its details page.
On the service details page, click the Access Information tab to view the service’s access information.
On the right side of the service you need to operate, click , then select Edit External Access from the dropdown list.

In the Edit External Access dialog box, set the external access mode for the service, then click OK.

The external access modes for a service include the following types:

Parameter	Description
None	The service cannot be accessed from outside the cluster.
NodePort	The system maps a node’s port to the service port, allowing access to the service via the node’s IP address and the node port.
LoadBalancer	The system allocates an external IP address for the service based on a NodePort service and binds the external IP address to an external load balancer. The external load balancer listens on the node port corresponding to the service, enabling access to the service via the external IP address. To achieve this functionality, a LoadBalancer type service requires support from a load balancer plugin and the underlying infrastructure environment, and relevant annotations need to be set. For more information, please contact your infrastructure environment provider.

Parameter

Description

None

The service cannot be accessed from outside the cluster.

NodePort

The system maps a node’s port to the service port, allowing access to the service via the node’s IP address and the node port.

LoadBalancer

The system allocates an external IP address for the service based on a NodePort service and binds the external IP address to an external load balancer. The external load balancer listens on the node port corresponding to the service, enabling access to the service via the external IP address. To achieve this functionality, a LoadBalancer type service requires support from a load balancer plugin and the underlying infrastructure environment, and relevant annotations need to be set. For more information, please contact your infrastructure environment provider.