Skip to main content

Get started

Have an account​

Your department team members or vendors must have an Azure AD account (with an email address). From there access is granted to users to a project in GitLab and OpenShift. Please visit the Assyst web portal to request a new user account if required or sponsor a vendor.

In order to access the platform you have to provide the devops team your AzureAD email address(s) to add to the AzureAD login the ability to sign-in.

Platform Overview​

The core of the Platform as a Service is an OpenShift solution specifically for government work. The customer team is responsible for their own code and the platform team is responsible for the security and maintenance of everything underneath. The platform is built to keep applications online with even large numbers of users and sharp increases in usage.

The platform is suitable for hosting a wide range of applications including websites and non-website applications for internal and public uses.

The platform runs on top of public cloud infrastructure and runs the OpenShift software distribution. This is a managed solution between our cloud infrastructure(Azure/Amazon) and RedHat SRE team's.

One of our goals for the service is to give agencies the access to a centralized PaaS model already compliant with governance rules. This reduces the work and cost of cloud adoption.

Shared responsibility model​

TODO

Access the OpenShift web console​

The NSDS Managed PaaS is hosted on OpenShift. As a part of OpenShift it provides a rich user interface for staff to deploy, maintain and troubleshoot their applications. This web UI is accessible via the VDI and PDN networks.

To login to either service use your Azure AD information and provided the DevOps team your account information.

  1. If you are using the on-premise development environment visit the nonprod-hfx1 console
  2. if you are using the Azure development environment visit the Azure console

Setup the OpenShift command line​

The NSDS Managed PaaS is hosted on OpenShift. You must use the OpenShift command line interface (CLI) to manage your apps hosted on the NSDS PaaS. To set it up:

  1. Download and install the OpenShift OC for your platform.
  2. Ensure it is installed correctly, run oc version in the command line.

If it has installed correctly, you will see a message Client Version: X.X.X-X... confirmation message.

You will need to be connected via VDI or VPN for the CLI to connect. Contact your network administrator for access.

Refer to the OpenShift CLI tools overview for more information on configuration of the tools.

Sign in to OpenShift CLI​

The required method to sign in to OpenShift is to use your Azure AD information.

  1. If you are using the on-premise development environment, run the following in the command line:

    oc login api.nonprod-hfx1.novascotia.ca:6443 --insecure-skip-tls-verify=true

  2. If you are using the Azure development environment, run the following in the command line:

    oc login api.wpg666vg.canadacentral.aroapp.io:6443

This will respond with instructions on how to acquire an API token via a web address to follow.

Following this URL will present you with an AzureAD login.

After signing in click on "Display Token"

Copy the information under the "Login with this token" section i.e.:

oc login --token=ATOKENDATA --server=https://api.nonprod-hfx1.novascotia.ca:6443

Paste this command into your command line to login.

Note: If you receive a certificate is not trusted error append --insecure-skip-tls-verify=true to the oc login command.