https://github.com/sonatype/operator-iq

IBM Operator for Nexus IQ
https://github.com/sonatype/operator-iq

lifecycle-integrations

Last synced: about 2 months ago
JSON representation

IBM Operator for Nexus IQ

• Host: GitHub
• URL: https://github.com/sonatype/operator-iq
• Owner: sonatype
• Created: 2020-02-28T21:19:26.000Z (almost 5 years ago)
• Default Branch: main
• Last Pushed: 2024-08-21T19:13:02.000Z (4 months ago)
• Last Synced: 2024-08-21T21:15:45.330Z (4 months ago)
• Topics: lifecycle-integrations
• Language: Shell
• Homepage:
• Size: 245 KB
• Stars: 1
• Watchers: 32
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: licenses/licenses.txt
  • Security: SECURITY.md

Awesome Lists containing this project

README

        
# Sonatype Nexus IQ Certified Operator

Red Hat certified OpenShift Operator for installing Sonatype Nexus IQ Server

to an OpenShift cluster.

## Building from Source for Local Development and Testing

To develop and test locally, you'll use CodeReady Containers on your workstation

and push your operator image to quay.io to make it available for installation.

1. Install [Red Hat OpenShift Local](https://developers.redhat.com/products/codeready-containers/overview) (formerly known as CodeReady Containers)

   for a local Openshift 4 environment.

2. Ensure you have a personal quay.io account.

3. Generate a new version of the operator image using the templates under test:

   `./scripts/new_version.sh image  `

   

   Get the certified app version from

   [IQ Server in the Red Hat Catalog](https://catalog.redhat.com/software/containers/sonatype/nexus-iq-server/5e5d8063ac3db90370816c66?container-tabs=gti)

   Example: `./scripts/new_version.sh image 1.145.0-1 1.145.0-ubi-1`

4. Build and deploy the operator image to your personal quay.io repository:

   1. `docker build . -f build/Dockerfile --tag quay.io//nxiq-operator-certified:[operator-version]`

   2. `docker login quay.io`

   3. `docker push quay.io//nxiq-operator-certified:[operator-version]`

5. Make sure the new image on quay.io is public, so that the OpenShift

   cluster can pull it. You should have **nxiq-operator-certified** repository with public visibility.

6. Update the bundle files for the new image:

   `./scripts/new_version.sh bundle   `

   

   Get the certified app ID URL from

   [IQ Server in the Red Hat Catalog](https://catalog.redhat.com/software/containers/sonatype/nexus-iq-server/5e5d8063ac3db90370816c66?container-tabs=gti)

   Example: `./scripts/new_version.sh bundle 1.145.0-1 quay.io/{quay.io-account}/nxiq-operator-certified:1.145.0-1 registry.connect.redhat.com/sonatype/nexus-iq-server@sha256:{sha256}` (*)

7. Install all the descriptors for the operator to your OpenShift cluster:

   1. `./scripts/install.sh`

   2. By executing `kubectl get pods` you should see a pod running in Openshift:

      `example-nexusiq-iqserver-{id}`

If `install.sh` does not work out of the box with "stderr.log: Permission Denied" error, try using a different namespace.

You can do this by creating a namespace first with

```

oc create ns nxiq9

```

Then modify both `install.sh` and `uninstall.sh` files to include the following suffix for each command:

```

-n nxiq9

```

For example, the first command in `install.sh` will become:

```

kubectl apply -f deploy/service_account.yaml -n nxiq9

```

8. Expose the new IQ Server outside the cluster: 

   1. Create a Route in OpenShift UI to the new service, using:

      

      **Port:** 8070 -> 8070.

      **Service:** example-nexusiq-iqserver-{id}

9. Visit the new URL shown on the Route page in OpenShift UI. And verify everything on the IQ Server side is working as expected.

10. Default credentials are `admin`/`admin123`.

## Uninstall Nexus IQ from a Local Test Cluster

1. Remove the route in the console.

2. Uninstall all the descriptors for the operator: `./scripts/uninstall.sh`