Skip to main content

Version: 3.11.0

Install APISIX on ROSA

Red Hat OpenShift Service on AWS (ROSA) is a fully managed service that provides a simplified way to deploy and manage OpenShift clusters on AWS.

Prerequisite(s)

Create a OpenShift Project and Service Account

Log in OpenShift CLI using the user account with cluster admin rights:

oc login <cluster-url> --username <username> --password <password>

Create an OpenShift project for APISIX:

oc new-project apisix

Switch the default project to apisix:

oc project apisix

Create a service account apisix-sa for APISIX deployment:

oc create sa apisix-sa

Add the security context constraint (SCC) nonroot-v2 to the service account:

oc adm policy add-scc-to-user nonroot-v2 -z apisix-sa

Install With Helm

Add APISIX Helm repository and update:

helm repo add apisix https://charts.apiseven.com
helm repo update

Install the APISIX Helm chart:

helm install apisix apisix/apisix \
--set gateway.type=NodePort \
--set etcd.podSecurityContext.enabled=false \
--set etcd.containerSecurityContext.enabled=false \
--set serviceAccount.name=apisix-sa

❶ Disable podSecurityContext and containerSecurityContext for etcd to avoid running into issues related to SCC.

❷ Deploy with the service account apisix-sa to grant APISIX the required permissions.

If successful, you should see a response similar to the following:

NAME: apisix
LAST DEPLOYED: Wed May 24 07:56:25 2023
NAMESPACE: apisix
STATUS: deployed

Verify Installation

Check pod statuses to make sure all pods are up and running:

oc get pod

The response should be similar to the following with all pods Running:

NAME                      READY   STATUS    RESTARTS   AGE
apisix-5899557df4-5wgcn 1/1 Running 0 6m33s
apisix-etcd-0 1/1 Running 0 6m33s
apisix-etcd-1 1/1 Running 0 6m33s
apisix-etcd-2 1/1 Running 0 6m33s

Send a request to APISIX to verify APISIX is running:

oc exec -itq apisix-5899557df4-5wgcn -- curl -I http://127.0.0.1:9080 | grep Server

You should see APISIX version in the response:

Server: APISIX/3.11.0

You have now successfully installed APISIX on ROSA.


API7.ai Logo

API Management for Modern Architectures with Edge, API Gateway, Kubernetes, and Service Mesh.

Product

API7 Cloud

SOC2 Type IIISO 27001HIPAAGDPRRed Herring

Copyright © APISEVEN Ltd. 2019 – 2024. Apache, Apache APISIX, APISIX, and associated open source project names are trademarks of the

Apache Software Foundation