Skip to main content
Version: 1.8.0

AISIX on OKD

AISIX deployment and upgrade guidance for OKD is organized by product so that each procedure contains one complete operator journey. Choose the product you run:

ProductDeployUpgrade
AISIX OSSDeploy AISIX OSS on OpenShift or OKDUpgrade AISIX OSS on OpenShift or OKD
AISIX EnterpriseDeploy AISIX Enterprise on OpenShift or OKDUpgrade AISIX Enterprise on OpenShift or OKD

Existing bookmarks to the original OKD guide continue to work at this URL. The maintained product-specific procedures also apply to Red Hat OpenShift.

AISIX Cloud access is coordinated through API7 rather than public self-service. Contact API7 for the applicable gateway deployment and upgrade workflow.

Understand the Security Context​

Each product procedure explains and verifies the restricted-v2 SCC for the workloads it installs.

Select an OKD Project​

Follow the project preparation in the deployment page for your product.

Choose Route Host Names​

Follow the Route preparation in the deployment page for your product.

Deploy a Gateway​

Deploy AISIX OSS. For AISIX Enterprise, the complete deployment deploys the control plane before its gateways.

Deploy AISIX Enterprise​

Follow Deploy AISIX Enterprise on OpenShift or OKD for the complete control-plane and gateway journey.

Expose AISIX with Routes​

Each product deployment page creates and verifies only the Routes required by that product.

Upgrade AISIX​

Upgrade AISIX OSS or the complete AISIX Enterprise product.

Troubleshoot a Web Console Upgrade​

The tested OKD web-console Helm dependency error is documented in Upgrade AISIX Enterprise on OpenShift or OKD.

Troubleshoot SCC Admission​

Use the SCC troubleshooting section in the upgrade page for your product.

Troubleshoot a Container Start Failure​

Use the container and CRI-O troubleshooting section in the upgrade page for your product.