Ingress

Ingress is an object that manages external access to services in a cluster. Ingress may provide load balancing and name-based virtual hosting.

To access ingress configuration:

• Under blueprint configurations, go to the Ingress tab as shown below.

  

---

Adding Ingress

1. Click the Add New Ingress button from the top left. A form will be displayed to add ingress as shown in the image below.

   Note: There will be only one ingress associated with each blueprint.

   

Prerequisites

Before adding ingress, ensure the following:

1. Blueprint must have at least one deployment
2. Blueprint must have a service to add rules
3. To add TLS information, you must have at least one TLS type secret

Ingress Configuration

Add ingress by providing the following details:

Field	Description
Ingress name	Enter the ingress name
Rules	Add at least one rule
TLS Information	Add TLS information (optional)
Labels and Annotations	Add labels and annotations (optional)

---

1. Ingress Name

Naming requirements: - Only lowercase alphanumeric characters, hyphens (-), or periods (.) are allowed - Must start and end with an alphanumeric character - Maximum 253 characters allowed - Name must be unique

---

2. Rules

Adding an Ingress Rule

1. Click the Add Rule button as shown below.

   

2. This will open the Add Ingress Rule form as shown below.

   

Rule Components

Each rule contains the following information:

• Host name: Provide the host name here. Once a host is provided (for example, nginx.com), the rules apply to that host.

• Paths: Provide a list of paths here. At least one path is required.

• Path: Provide the path here.

• Path types: Each path in an ingress is required to have a corresponding path type. There are three supported path types:

  • ImplementationSpecific
  • Exact
  • Prefix

• Service and service port:

  • Services added under the selected blueprint will be listed here
  • Select a service and its corresponding port
  • Each rule is associated with a service name and a service port

1. After adding rule details, click Save Rule to save the rule.

   

Important Note:
At least one rule is needed to create an ingress.

---

3. TLS Information

Adding TLS Information

1. Click the Add TLS button. This will add an empty row where you can add details as shown below.

   

2. Provide the following details under TLS Information:

Secrets

• Select a TLS secret from the list
• TLS secrets added from the Secrets section will be listed here
• You can also create a secret directly by clicking [Add new TLS secret] from the secrets column as shown below.

    ![Cruize ingress](../cruize-images/ingress/addbtn.png)

Host

• Provide a comma-separated list of multiple hosts
• Provide the host name as mentioned in the rules section

---

4. Labels & Annotations

Click here to learn more about labels and annotations.

---

Save Ingress

Once all details are provided, click the Save button to add the ingress.

---

View Ingress Data

To view ingress rule, TLS information, and labels & annotations:

• Click the View (Eye) icon from the actions column in the ingress table as shown in the image below.

  

  

---

Edit Ingress

To edit ingress data:

1. Click the Edit icon from the actions column in the ingress table as shown in the image below.

   

2. This will open a form with the data to edit. After editing, click the Update button to save the changes.

   

---

Delete Ingress

To delete an ingress:

• Click the Delete icon from the actions column of the ingress as shown in the image below.

• This will remove the deleted ingress.