# 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.

<figure><img src="/files/owOuxmG62XSUYvBbeobN" alt=""><figcaption><p>[Screen] Ingress Screen in Service Map</p></figcaption></figure>

### 1.2 **Entering Basic Ingress Information**

1\) Provide the necessary basic information for Ingress configuration.

<figure><img src="/files/oLLdgRmkCYi2vEOI6h9e" alt=""><figcaption><p>[Screen] Enter Basic Information for Ingress</p></figcaption></figure>

<table><thead><tr><th width="170">Item (* is required)</th><th>Content</th></tr></thead><tbody><tr><td>ingress name*</td><td>Write the name of the Ingress you want to register</td></tr><tr><td>Ingress Controller*</td><td>Select the installed Ingress controller</td></tr><tr><td>SSL Redirect</td><td>If using an SSL certificate and need to automatically redirect from HTTP to HTTPS, choose TRUE</td></tr><tr><td>Label</td><td>Input labels to be registered for the Ingress</td></tr><tr><td>Annotation</td><td>Input comments to be registered for the Ingress</td></tr></tbody></table>

{% hint style="info" %}
To configure automatic redirection from HTTP to HTTPS, set SSL Redirect to true and include force-ssl-redirect: true in the comments.
{% endhint %}

<figure><img src="/files/tcdyGlYxDaenpHh6Lkmj" alt=""><figcaption><p>[Screen] Ingress Name and Controller Information Input Screen</p></figcaption></figure>

<figure><img src="/files/lhLq3j1uBCi417dcd89M" alt=""><figcaption><p>[Screen] Ingress Annotation Input Screen</p></figcaption></figure>

### 1.3 **Entering Ingress Rules**

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

<figure><img src="/files/JKnjEYr8EfigziP2aODN" alt=""><figcaption><p>[Screen] Ingress Rule Configuration</p></figcaption></figure>

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.".

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

### 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."

<figure><img src="/files/oZOhb0PBfX1m6GGqAEue" alt=""><figcaption><p>[Screen] Ingress TLS Configuration</p></figcaption></figure>

<table><thead><tr><th width="170">Item (* is required)</th><th>Content</th></tr></thead><tbody><tr><td>Secret*</td><td>Select the public certificate Secret that has been previously registered</td></tr><tr><td>Targeted host*</td><td>Choose the host for which TLS certificates will be applied</td></tr></tbody></table>

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.

<figure><img src="/files/2zyuAWKb3yza4AURK7CI" alt=""><figcaption><p>[Screen] Ingress List View</p></figcaption></figure>

### 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.

<figure><img src="/files/exFobpvBoDw8Ti1fsmvX" alt=""><figcaption><p>[Screen] Ingress Detailed Information View</p></figcaption></figure>

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.

<figure><img src="/files/S6NDgUcXXBogmZ857bGv" alt=""><figcaption><p>[Screen] View YAML Format of Ingress Configuration and Status Information</p></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://cocktailcloud.gitbook.io/cocktail-cloud-online-en/application/ingress.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.