Ingress

1. Ingress Creation

Ingress is a feature that allows controlling HTTP/HTTPS routing from outside the cluster to internal services within the cluster. To create Ingress, it is necessary to install the Ingress controller in the cluster beforehand through the Cocktail Cloud's addon management screen.

1.1 Accessing the Ingress Screen

1) Click on the "+ Create" button at the top right of the Ingress screen in the Service Map.

[Screen] Ingress Screen in Service Map

1.2 Entering Basic Ingress Information

1) Provide the necessary basic information for Ingress configuration.

[Screen] Enter Basic Information for Ingress

Item (* is required)	Content
ingress name*	Write the name of the Ingress you want to register
Ingress Controller*	Select the installed Ingress controller
SSL Redirect	If using an SSL certificate and need to automatically redirect from HTTP to HTTPS, choose TRUE
Label	Input labels to be registered for the Ingress
Annotation	Input comments to be registered for the Ingress

To configure automatic redirection from HTTP to HTTPS, set SSL Redirect to true and include force-ssl-redirect: true in the comments.

[Screen] Ingress Name and Controller Information Input Screen

[Screen] Ingress Annotation Input Screen

1.3 Entering Ingress Rules

1) Click the "Edit" button in the "Rules" section of Ingress settings.

[Screen] Ingress Rule Configuration

2) When adding a host, enter the desired host name and click "+ Add."

If there are pre-registered hosts, select "Select from existing hosts" and click "+ Add.".

Item (* is required)	Content
host*	The entered host is specified by adding it
path*	Select the installed Ingress controller
Path Type*	Prefix: Matches values by separating the prefix of the URL path based on /, distinguishing between uppercase and lowercase. ImplementationSpecific: Varies depending on IngressClass, can be separated by a separate pathType, or use the path type the same as Prefix or Exact Exact: Strictly distinguishes the case of the URL path
Target Service*	Choose the service to connect to the Ingress among the currently created exposed services
Targeted Service Port*	Select the port to be served by the service

1.4 Entering Ingress TLS Information

Configure TLS-related information for Ingress, including secrets used to terminate TLS traffic on port 443 and host information included in TLS certificates.

1) Click the "Edit" button in the "TLS" section of Ingress settings.

2) Select the Secret and target host, then click "+ Add."

[Screen] Ingress TLS Configuration

Item (* is required)	Content
Secret*	Select the public certificate Secret that has been previously registered
Targeted host*	Choose the host for which TLS certificates will be applied

3) After completion, click "Apply."

1.5 Save

1) To actually create the Ingress, be sure to click the "Save" button.

2. Viewing Ingress

Access the [Ingress] screen in the Service Map to view the created Ingress information.

2.1 Viewing Ingress List

1) In the [Ingress] screen of the Service Map, view the list of Ingress.

[Screen] Ingress List View

2.2 Viewing Detailed Ingress Information

1) Click on the Ingress name link displayed in the Ingress list. The configuration and status information of the Ingress will be displayed.

[Screen] Ingress Detailed Information View

2) You can also view Ingress settings information and status information in YAML format. After clicking the "Settings" button at the top of the screen, select "YAML View" as the settings view at the top of the screen to display information in YAML format.

[Screen] View YAML Format of Ingress Configuration and Status Information