Skip to content

Commit 42caa50

Browse files
authored
Merge branch 'master' into type-lb-benefits
2 parents 23519c0 + 61beba8 commit 42caa50

758 files changed

Lines changed: 49880 additions & 7788 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

.github/ISSUE_TEMPLATE/bug_report.md

Lines changed: 9 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -10,20 +10,25 @@ assignees: ''
1010
**Describe the bug**
1111
A clear and concise description of what the bug is.
1212

13-
**Slack Channel**
14-
To request an invitation to participate in the Slack channel, please supply your email address using this form: https://podio.com/webforms/22979270/1633242
1513

1614
**To Reproduce**
1715
1. Steps
18-
2. Version of the Citrix Ingress Controller
16+
2. Version of the NetScaler Ingress Controller
1917
3. Version of MPX/VPX/CPX
2018
4. Environment variables (minus secrets)
2119

2220
**Expected behavior**
2321
A clear and concise description of what you expected to happen.
2422

2523
**Logs**
26-
kubectl logs
24+
25+
kubectl logs
26+
27+
To facilitate a more efficient troubleshooting process and identify the issue, we recommend utilizing the [NSIC Diagnostic tool](https://github.com/netscaler/modern-apps-toolkit/tree/main/cic_diagnostics_tool). This tool will gather deployment logs and other essential details that are crucial for our analysis.
2728

2829
**Additional context**
30+
2931
Add any other context about the problem here.
32+
33+
34+
If you need faster resolution or need to share logs, please feel free to reach out to us via email at **[email protected]**. We'll be happy to assist you promptly.

.gitignore

Lines changed: 0 additions & 1 deletion
This file was deleted.

.gitmodules

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
[submodule "devdocs-theme"]
2+
path = devdocs-theme
3+
url = https://github.com/citrix/devdocs-theme.git

CONTRIBUTING.md

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
# Contributing to the Netscaler ingress controller
2+
3+
We are glad to know that you want to contribute to this project! This document helps to answer common questions you may have during your first contribution.
4+
5+
## Submitting issues
6+
7+
Not every contribution comes in the form of code. Submitting, confirming, and triaging issues is an important task for any project. This project uses GitHub to track all project issues. You can use Issues to submit feature requests.
8+
9+
We ask you not to submit security concerns through GitHub. For details on submitting potential security issues, see [reporting security issues to Citrix](https://support.citrix.com/article/CTX081743).
10+
11+
## Code contributions
12+
13+
At this point, we are not accepting code contributions from outside Citrix for this project. You can raise an issue if you want to see a feature.

README.md

Lines changed: 45 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -1,78 +1,94 @@
1-
[![Docker Repository on Quay](https://quay.io/repository/citrix/citrix-k8s-ingress-controller/status "Docker Repository on Quay")](https://quay.io/repository/citrix/citrix-k8s-ingress-controller)
1+
[![Docker Repository on Quay](https://quay.io/repository/netscaler/netscaler-k8s-ingress-controller/status)](https://quay.io/repository/netscaler/netscaler-k8s-ingress-controller)
22
[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](./license/LICENSE)
3-
[![GitHub stars](https://img.shields.io/github/stars/citrix/citrix-k8s-ingress-controller.svg)](https://github.com/citrix/citrix-k8s-ingress-controller/stargazers)
4-
[![HitCount](http://hits.dwyl.com/citrix/citrix-k8s-ingress-controller.svg)](http://hits.dwyl.com/citrix/citrix-k8s-ingress-controller)
5-
3+
[![GitHub stars](https://img.shields.io/github/stars/netscaler/netscaler-k8s-ingress-controller.svg)](https://github.com/netscaler/netscaler-k8s-ingress-controller/stargazers)
4+
[![HitCount](https://hits.dwyl.com/netscaler/netscaler-k8s-ingress-controller.svg)](http://hits.dwyl.com/netscaler/netscaler-k8s-ingress-controller)
5+
[![Artifact Hub](https://img.shields.io/endpoint?url=https://artifacthub.io/badge/repository/netscaler)](https://artifacthub.io/packages/search?repo=netscaler)
66
---
77

8-
# Citrix ingress controller
8+
# NetScaler Ingress Controller
99

1010
## Description
1111

12-
This repository contains Citrix ingress controller built around [Kubernetes Ingress](https://kubernetes.io/docs/concepts/services-networking/ingress/).
13-
##### Participate:
12+
This repository contains the NetScaler ingress controller built around [Kubernetes Ingress](https://kubernetes.io/docs/concepts/services-networking/ingress/).
13+
### Participate:
14+
15+
You can reach out for any questions via our email: **[email protected]**.
1416

15-
You can discuss questions/bugs/feature requests for this project on our Slack channel. To request an invitation to participate in the Citrix ADC Cloud Native Slack channel(citrixadccloudnative.slack.com), please supply your email address using this form: https://podio.com/webforms/22979270/1633242 . You can also create issues using the bug reporting template.
17+
To enhance our understanding of your Kubernetes/microservices application deployment architecture and provide you with the latest NetScaler capabilities, we kindly request you to fill out [Requirement Gathering Questionnaire](https://docs.google.com/forms/d/e/1FAIpQLSd9ueKkfgk-oy8TR1G5cp5HexFwU03kkwx_CvDyOFVFweuXOw/viewform). Your valuable insights will enable us to better serve your specific needs. Thank you for taking the time to contribute to our understanding and improvement efforts.
1618

1719
## What is an ingress controller?
1820

19-
An Ingress Controller is a controller that watches the Kubernetes API server for updates to the Ingress resource and reconfigures the Ingress load balancer accordingly.
21+
An Ingress Controller is a [controller](https://kubernetes.io/docs/concepts/architecture/controller/) that watches the Kubernetes API server for updates to the Ingress resource and reconfigures the Ingress load balancer accordingly.
2022

21-
## What is Citrix ingress controller?
23+
## What is the NetScaler ingress controller?
2224

23-
Citrix provides an ingress controller for Citrix ADC MPX (hardware), Citrix ADC VPX (virtualized), and Citrix ADC CPX (containerized) for [bare metal](https://github.com/citrix/citrix-k8s-ingress-controller/tree/master/deployment/baremetal) and [cloud](https://github.com/citrix/citrix-k8s-ingress-controller/tree/master/deployment) deployments. It is built around Kubernetes [Ingress](https://kubernetes.io/docs/concepts/services-networking/ingress/) and automatically configures Citrix ADC based on the Ingress resource configuration.
25+
NetScaler provides an ingress controller for NetScaler MPX (hardware), NetScaler VPX (virtualized), and NetScaler CPX (containerized) for [bare metal](https://github.com/netscaler/netscaler-k8s-ingress-controller/tree/master/deployment/baremetal) and [cloud](https://github.com/netscaler/netscaler-k8s-ingress-controller/tree/master/deployment) deployments. It is built around Kubernetes [Ingress](https://kubernetes.io/docs/concepts/services-networking/ingress/) and automatically configures NetScaler based on the Ingress resource configuration.
2426

25-
The Citrix ingress controller can be deployed either by directly using [yamls](https://github.com/citrix/citrix-k8s-ingress-controller/tree/master/deployment/baremetal) or by [helm charts](https://github.com/citrix/citrix-k8s-ingress-controller/tree/master/charts).
27+
The NetScaler ingress controller can be deployed either by directly using [yamls](https://github.com/netscaler/netscaler-k8s-ingress-controller/tree/master/deployment/baremetal) or by [helm charts](https://github.com/netscaler/netscaler-k8s-ingress-controller/tree/master/charts).
2628

2729
## Features
2830

29-
Features supported by Citrix ingress controller can be found [here](https://github.com/citrix/citrix-k8s-ingress-controller/tree/master/deployment).
31+
Features supported by the NetScaler ingress controller can be found [here](https://github.com/netscaler/netscaler-k8s-ingress-controller/tree/master/deployment).
32+
The NetScaler API Gateway features can be found [here](https://github.com/netscaler/netscaler-k8s-ingress-controller/blob/master/docs/deploy/citrix-api-gateway.md).
3033

3134
## Supported platforms and deployments
3235

3336
Click [here](docs/support-matrix.md) for detailed list of supported platforms and deployments.
3437

3538
## Documentation
3639

37-
For detailed documentation, see [Citrix ingress controller Live Documentation](https://developer-docs.citrix.com/projects/citrix-k8s-ingress-controller/en/latest/).
40+
For detailed documentation, see the [Netscaler ingress controller Live Documentation](https://docs.netscaler.com/en-us/netscaler-k8s-ingress-controller/).
3841

3942
## Deployment solutions
4043

41-
You can deploy Citrix ingress controller in many platforms. For detailed information, see [Deployment Architecture](https://github.com/citrix/citrix-k8s-ingress-controller/tree/master/deployment).
44+
You can deploy the NetScaler ingress controller in many platforms. For detailed information, see [Deployment Architecture](https://github.com/netscaler/netscaler-k8s-ingress-controller/tree/master/deployment).
4245

4346
## Examples
4447

45-
Deploy the Guestbook application and use the [Citrix ADC CPX](https://www.citrix.com/products/citrix-adc/cpx-express.html) to provide the Ingress:
48+
Deploy the Guestbook application and use the [NetScaler CPX](https://docs.netscaler.com/en-us/cpx/current-release/about.html) to provide the Ingress:
4649

47-
- [Quick Deploy using yaml](./example)
48-
- [Quick Deploy using Helm](https://github.com/citrix/citrix-k8s-ingress-controller/tree/master/charts/examples)
50+
- [Quick Deploy using YAML](./example)
51+
- [Quick Deploy using Helm](https://github.com/netscaler/netscaler-helm-charts/tree/master/examples/netscaler-cpx-with-ingress-controller)
4952
- [Quick Deploy using Kops](./docs/deploy/deploy-cic-kops.md)
50-
- [Deployment in Google Cloud](https://github.com/citrix/citrix-k8s-ingress-controller/blob/master/deployment/gcp)
51-
- [Deployment in Azure Cloud](https://github.com/citrix/citrix-k8s-ingress-controller/tree/master/deployment/azure)
53+
- [Deployment in Google Cloud](https://github.com/netscaler/netscaler-k8s-ingress-controller/blob/master/deployment/gcp)
54+
- [Deployment in Azure Cloud](https://github.com/netscaler/netscaler-k8s-ingress-controller/tree/master/deployment/azure)
5255

5356
## Release notes
5457

55-
Click [here](https://github.com/citrix/citrix-k8s-ingress-controller/releases) for the release notes of the latest Citrix ingress controller release.
58+
Click [here](https://github.com/netscaler/netscaler-k8s-ingress-controller/releases) for the release notes of the latest NetScaler ingress controller release.
5659

57-
## Questions
60+
## Questions and support
5861

5962
For questions and support the following channels are available:
6063

61-
- [Citrix Discussion Forum](https://discussions.citrix.com/forum/1657-netscaler-cpx/)
62-
- [Citrix ADC CPX Slack Channel](https://citrixadccloudnative.slack.com/)
64+
- [NetScaler Discussion Forum](https://community.citrix.com/forums/forum/8-microservices/)
65+
66+
To enhance our understanding of your Kubernetes/microservices application deployment architecture and provide you with the latest NetScaler capabilities, we kindly request you to fill out [Requirement Gathering Questionnaire.](https://docs.google.com/forms/d/e/1FAIpQLSd9ueKkfgk-oy8TR1G5cp5HexFwU03kkwx_CvDyOFVFweuXOw/viewform). Your valuable insights will enable us to better serve your specific needs. Thank you for taking the time to contribute to our understanding and improvement efforts.
67+
68+
For more information about NetScaler cloud native solutions, you can reach out to the NetScaler product team at: **[email protected]**
6369

64-
To request an invitation to participate in the Slack channel, please supply your email address using this form: [https://podio.com/webforms/22979270/1633242](https://podio.com/webforms/22979270/1633242)
70+
![ ](./docs/media/contact-team.png)
71+
72+
### NetScaler `kubectl` plugin
73+
NetScaler offers a convenient [kubectl plugin](https://github.com/netscaler/modern-apps-toolkit/blob/main/netscaler-plugin/README.md) designed to inspect NetScaler Ingress controller deployments and conduct troubleshooting operations. This feature is available from CIC version 1.32.7 onwards. Utilize the various subcommands provided by this plugin to streamline your troubleshooting process and gain valuable insights into your Ingress controller setup. We encourage you to explore the capabilities of this plugin for a more effective and efficient management of your deployments.
6574

6675
## Issues
6776

68-
Please report the issues in detail. Use the following command to collect the logs:
77+
Describe issues in detail, collect logs, and use the [discussion forum](https://community.citrix.com/forums/forum/8-microservices/) to report issues.
78+
79+
Use the following command to collect logs:
6980

7081
```
71-
Get Logs: kubectl logs citrix-k8s-ingress-controller > log_file
82+
Get Logs: kubectl logs netscaler-k8s-ingress-controller > log_file
7283
```
7384

74-
You can report the issues using the following forum:
75-
`https://discussions.citrix.com/forum/1657-netscaler-cpx/`
85+
To facilitate a more efficient troubleshooting process and identify the issue, we recommend utilizing the [CIC Diagnostic tool](https://github.com/netscaler/modern-apps-toolkit/tree/main/cic_diagnostics_tool). This tool will gather deployment logs and other essential details that are crucial for our analysis.
86+
87+
You can report any issues using the following forum:
88+
`https://community.citrix.com/forums/forum/8-microservices/`
89+
90+
For information on how to troubleshoot some of the common issues that you may encounter while using NetScaler CPX, see the
91+
[NetScaler CPX documentation](https://docs.netscaler.com/en-us/cpx/current-release/cpx-troubleshooting.html).
7692

7793
## Code of Conduct
7894

0 commit comments

Comments
 (0)