From 43118a099c05f714de52a48490a6630d1c7d1969 Mon Sep 17 00:00:00 2001 From: John Peterson Date: Thu, 13 Feb 2020 14:05:23 -0800 Subject: [PATCH] README for artifactory-ha-operator formatting updates --- Openshift4/README.md | 7 +++ Openshift4/artifactory-ha-operator/README.md | 59 +++++++++++++++----- 2 files changed, 53 insertions(+), 13 deletions(-) create mode 100644 Openshift4/README.md diff --git a/Openshift4/README.md b/Openshift4/README.md new file mode 100644 index 0000000..fbd9ee7 --- /dev/null +++ b/Openshift4/README.md @@ -0,0 +1,7 @@ +# Openshift 4 Operators + +## Artifactory HA + +To install Artifactory HA as an Openshift 4 operator please use the console's OperatorHub to install the official operator. + +To install the operator locally please refer to the instructions that can be found in the README under artifactory-ha-operator. diff --git a/Openshift4/artifactory-ha-operator/README.md b/Openshift4/artifactory-ha-operator/README.md index a2751f1..8e442dd 100644 --- a/Openshift4/artifactory-ha-operator/README.md +++ b/Openshift4/artifactory-ha-operator/README.md @@ -1,4 +1,4 @@ -# Openshift 4 Artifactory Operator +# Artifactory HA Operator ## Cluster Setup ###### Security Context Constraints - Anyuid @@ -6,7 +6,9 @@ Openshift only allows statefulsets / pods to run in specific user and group id r Artifactory currently uses users outside of this allowed range. For this reason the service account for the operator in the jfrog-artifactory namespace must be granted anyuid privileges. -Ex: oc adm policy add-scc-to-user anyuid system:serviceaccount:jfrog-artifactory:artifactory-ha-operator +``` +oc adm policy add-scc-to-user anyuid system:serviceaccount:jfrog-artifactory:artifactory-ha-operator +``` Where anyuid is the Security context constraint being applied to the service account artifactory-ha-operator in namespace jfrog-artifactory. @@ -20,9 +22,11 @@ A security context constraint has been created for hostpath in deploy/hostpathsc You can apply the security context constraint and hostpath plugin patch via these commands: +``` oc apply -f deploy/hostpathscc.yaml oc patch securitycontextconstraints.security.openshift.io/hostpath --type=merge --patch='{"allowHostDirVolumePlugin": true}' oc adm policy add-scc-to-user hostpath system:serviceaccount:jfrog-artifactory:artifactory-ha-operator +``` Or if you run setup.sh these will already be done. @@ -34,26 +38,35 @@ If your cluster does not already have existing persistent volumes that are 200Gi Example persistent volumes can be found at: +``` helm-charts/openshift-artifactory-ha/pv-examples +``` If you create the five folders on each node: - /mnt/pv-data/pv0001-large - /mnt/pv-data/pv0002-large - /mnt/pv-data/pv0003-large - /mnt/pv-data/pv0004-large - /mnt/pv-data/pv0005-large +``` +mkdir -p /mnt/pv-data/pv0001-large +mkdir -p /mnt/pv-data/pv0002-large +mkdir -p /mnt/pv-data/pv0003-large +mkdir -p /mnt/pv-data/pv0004-large +mkdir -p /mnt/pv-data/pv0005-large +``` You can then apply the example persistent volumes to your cluster with: +``` oc apply -f helm-charts/openshift-artifactory-ha/pv-examples +``` ## Installation types ###### OLM Catalog To install via the OLM catalog download the operator from the Operator hub and install it via the Openshift console GUI To test OLM catalog installs you will need to deploy the lastest ClusterServiceVersion found at: - deploy/olm-catalog/artifactory-ha-operator/X.X.X/artifactory-ha-operator.vX.X.X.clusterserviceversion.yaml + +``` +deploy/olm-catalog/artifactory-ha-operator/X.X.X/artifactory-ha-operator.vX.X.X.clusterserviceversion.yaml +``` This will install the operator into whatever cluster your kubectl or oc program is currently logged into. @@ -64,7 +77,9 @@ To install the operator via the Operator YAML follow the Local Testing tests. Instead of running operator-sdk up local for the last step run: +``` oc apply -f deploy/operator.yaml +``` This will deploy the operator into the cluster. @@ -78,18 +93,36 @@ Install code ready containers if you do not already have it installed. Run your cluster with 2 cpus and 8192 MBs of memory at a minimum to support HA: +``` crc start -c 2 -m 8192 +``` Recommended settings: +``` crc start -c 4 -m 16384 +``` -Create file: JFrog-Cloud-Installers/Openshift4/artifactory.cluster.license - Paste your license keys into this file for HA configuration of multiple nodes. - Note: License keys must be separated by two new lines. +Create file: -Run: setup.sh +``` +JFrog-Cloud-Installers/Openshift4/artifactory.cluster.license +``` + +Paste your license keys into this file for HA configuration of multiple nodes. + +* License keys must be separated by two new lines. * + +Run: + +``` +JFrog-Cloud-Installers/Openshift4/artifactory-ha-operator/setup.sh +``` ###### Operator-sdk local -Run: operator-sdk up local \ No newline at end of file +Run: + +``` +operator-sdk up local +``` \ No newline at end of file