Custom domain names let your Flink jobs resolve hostnames to specific IP addresses without relying on external DNS. This is useful when your upstream or downstream services — such as databases, message queues, or internal APIs — use private or non-standard hostnames that aren't resolvable from the Flink worker nodes.
Each entry maps a Host (hostname) to an IP (address). Any change requires a job restart to take effect.
Prerequisites
Before you begin, ensure that you have:
-
A workspace in the Running state — domain names can only be added while the workspace is running
-
A hostname that uses only lowercase characters — uppercase is not supported
Add a domain name
-
Log on to the Realtime Compute for Apache Flink console.
-
Find the workspace you want to manage, then in the Actions column, choose More > Managing Domain.
-
In the Managing Domain dialog box, click Add Domain.
-
Enter the Host and IP values, then click Save. Make sure both the hostname and IP address are valid.
-
Click OK.
Restart the job after adding a domain name for the change to take effect.
Modify a domain name
-
Log on to the Realtime Compute for Apache Flink console.
-
Find the workspace you want to manage, then in the Actions column, choose More > Managing Domain.
-
In the Managing Domain dialog box, find the domain name to update and click Edit in the Action column.
-
Update the Host and IP values, then click Save. Make sure both the hostname and IP address are valid.
-
Click OK.
Restart the job after modifying a domain name for the change to take effect.
Delete a domain name
-
Log on to the Realtime Compute for Apache Flink console.
-
Find the workspace you want to manage, then in the Actions column, choose More > Managing Domain.
-
In the Managing Domain dialog box, find the domain name to remove and click Delete in the Action column.
-
Click OK.
Restart the job after deleting a domain name for the change to take effect.
Limits
| Constraint | Detail |
|---|---|
| Hostname format | Uppercase characters are not supported |
| Maximum entries per workspace | 50 |
| Required workspace state | The workspace must be in the Running state to add domain names |
| Restart required | All changes (add, modify, delete) take effect only after a job restart |