Red Hat SummitEste conteúdo não está disponível no idioma selecionado.
Chapter 6. Installing the 3scale Operator
6.1. Introduction
In this documentation you will find details about deploying custom resource definitions (CRDs), deploying role-based access control (RBAC), and deploying the 3scale operator image for managing deployments of the same configuration in multiple environments.
The 3scale operator is a Technology Preview feature only. Technology Preview features are not supported with Red Hat production service level agreements (SLAs) and might not be functionally complete. Red Hat does not recommend using them in production. These features provide early access to upcoming product features, enabling customers to test functionality and provide feedback during the development process. For more information about the support scope of Red Hat Technology Preview features, see Technology Preview Features Support Scope.
6.1.1. Prerequisites
- A 3scale 2.5 On-Premises instance
OpenShift Container Platform 3.11
- A user account with administrator privileges in the OpenShift cluster
Deploy the 3scale operator and custom CRDs in a separate project. If you deploy them in an existing project containing infrastructure, it could alter or delete existing elements.
6.2. Creating a new OpenShift project
You must run a command like the one shown below to create a new OpenShift project. This command shows you an example of a project name:
oc new-project operator-test
oc new-project operator-testThis will create a new OpenShift project where the operator, the APIManager custom resource (CR) and the Capabilities custom resources will be installed.
6.2.1. Registering the 3scale operator CRDs in the OpenShift API server
- Download and uncompress the the tar file: deploy.tar.gz.
Log in as an administrator in the cluster and deploy all the 3scale operator CRDs by running the following command:
for i in `ls deploy/crds/*_crd.yaml`; do oc create -f $i ; done
for i in `ls deploy/crds/*_crd.yaml`; do oc create -f $i ; doneCopy to Clipboard Copied! Toggle word wrap Toggle overflow - This will register the APIManager CRD and the CRDs related to the Capabilities functionality of the operator in the OpenShift API server.
If the command runs successfully, you should be able to query the resource types defined by this CRDs via
oc get.For example, to verify that the APIManager CRD has been correctly registered, execute the following command:
oc get apimanagers
oc get apimanagersCopy to Clipboard Copied! Toggle word wrap Toggle overflow
You should see the following output:
No resources found.
No resources found.Copy to Clipboard Copied! Toggle word wrap Toggle overflow
6.2.2. Deploying roles and ServiceAccounts for the 3scale operator
Go to the
operator-testOpenShift project and make sure that no other elements exist:export NAMESPACE="operator-test" oc project ${NAMESPACE} oc get all // This shouldn't return any resultexport NAMESPACE="operator-test" oc project ${NAMESPACE} oc get all // This shouldn't return any resultCopy to Clipboard Copied! Toggle word wrap Toggle overflow Deploy the ServiceAccount that will be used by the 3scale operator:
oc create -f deploy/service_account.yaml
oc create -f deploy/service_account.yamlCopy to Clipboard Copied! Toggle word wrap Toggle overflow Log in as an administrator to the cluster and deploy the 3scale operator Role and the RoleBinding that will attach that role to the created ServiceAccount:
// As a cluster admin export NAMESPACE="operator-test" oc project ${NAMESPACE} oc create -f deploy/role.yaml oc create -f deploy/role_binding.yaml// As a cluster admin export NAMESPACE="operator-test" oc project ${NAMESPACE} oc create -f deploy/role.yaml oc create -f deploy/role_binding.yamlCopy to Clipboard Copied! Toggle word wrap Toggle overflow
6.2.3. Deploying the 3scale operator
Deploy the 3scale operator by executing the following commands:
export NAMESPACE="operator-test" oc project ${NAMESPACE} oc create -f deploy/operator.yamlexport NAMESPACE="operator-test" oc project ${NAMESPACE} oc create -f deploy/operator.yamlCopy to Clipboard Copied! Toggle word wrap Toggle overflow - This will create a Deployment that will contain a Pod with the Operator code and will start listening to incoming APIManager and Capabilities resources.
To verify the 3scale operator is deployed and ready, run the following command:
oc get deployment 3scale-operator
oc get deployment 3scale-operatorCopy to Clipboard Copied! Toggle word wrap Toggle overflow
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}