Environment setup for OpsMx ISD
Last updated
Was this helpful?
Last updated
Was this helpful?
You should have internet access and should be able to access github.com, docker.io, and quay.io. The following tools should be installed on your system.
curl
git
kubectl-cli
kubectl-helm
choco package manager (only for windows)
In addition, you need to create a Github repository.
Please follow the instructions that are specific to your laptop/machine operating system.
curl, git : Mac comes preinstalled with these commands
kubectl: Install using instructions , using homebrew is generally easier
Helm: Install using instructions , using homebrew is generally easier
Execute the following command in Powershell (running in administrator mode)
Set-ExecutionPolicy Bypass -Scope Process -Force; `iex ((New-Object
System.Net.WebClient).DownloadString('https://chocolatey.org/install.ps1'))
curl: Execute this command at the power shell prompt: choco install curl
git: Execute this command at the power shell prompt: choco install git
kubectl: Execute this command at the power shell prompt: choco install Kubernetes-cli
helm: Execute this command at the power shell prompt: choco install kubernetes-helm
Verification:
Execute the following commands to verify that the commands are functional:
Login to GitHub (github.com) with your own credentials.
Choose Private
Check “Add a README file”
You can skip this section if you are using another ingress controller, such as one provided by the cloud provider.
kubectl create ns ingress-nginx
helm repo add ingress-nginx https://kubernetes.github.io/ingress-nginx
helm repo update
helm install ingress-nginx ingress-nginx/ingress-nginx -n ingress-nginx
Check whether it is installed correctly or not, use$kubectl get svc -n ingress-nginx
Note down the IP Address (or hostname) of the “ingress-nginx-controller” service in the output of the command above. This is required for making DNS or host entries as mentioned in the section below.
You can skip this section if you're creating your own TLS certificates or the cluster doesn't have inbound port 80 access.
kubectl create namespace cert-manager
helm repo add jetstack https://charts.jetstack.io
helm repo update
helm install cert-manager jetstack/cert-manager --set installCRDs=true -n cert-manager
Using DNS to map url-hostnames to IP addresses is the preferred method. However, in case you don’t have access to a DNS server, for trial purposes, we can access the ISD by manually adding the IP->host mapping in the “hosts” file as follows:
section provides instructions for modifying your hosts file
Please create 3 entries as follows. The IP address is the “ingress-nginx-controller” service external IP address (as mentioned in the Nginx section above) and map them to the hostnames you defined for ISD.
Ip-address oes.com
Ip-address oes-gate.com
Ip-address spin...com [Example: oes.opsmx-isd.opsmx.com]
If you skipped the step in defining host-names, create these entries, replacing the “ip-address” as explained above:
Ip-address oes.isd-pov.example.com
Ip-address oes-gate.isd-pov.example.com
Ip-address spin.isd-pov.example.com
Please create add these three lines replacing the “ip-address” with the IP-address is the “ingress-nginx-controller” service external IP address
Ip-address oes.isd-pov.example.com
Ip-address oes-gate.isd-pov.example.com
Ip-address spin.isd-pov.example.com [Example: 35.22.105.22 oes.isd-pov.example.com]
Please create 3 entries as follows. The IP-address is the “ingress-nginx-controller” service external IP address (as mentioned in the Nginx section above) and map them to the hostnames you defined for ISD.
Ip-address oes.com
Ip-address oes-gate.com
Ip-address spin.com [Example: 35.22.105.22 oes.opsmx-isd.opsmx.com]
Curl: install using instructions
git: Install using instructions
kubectl: Install using instructions , go with “using native package manager” if you are not sure.
Helm: Install helm using the instructions , using a package manager is generally easier
Github.com offers a free personal account. If you don't already have an account, follow the instructions to create a new account.
Create a new private repository, instructions are . While creating:
Rename “main” branch as “master” branch by following the instructions .
Generate a personal access token by following the instructions . Save this token to be updated in values.yaml later.
Please follow the instructions .
If you do NOT have DNS, add lines in hosts file as shown below, by following the instructions :
If using DNS, add the entries in host file as shown below, by following the instructions :