Prerequisites

• VirtualBox 5.0 or higher
• Install the CF CLI
• Install PCF Dev
• Reference for installing PCFDev: https://docs.pivotal.io/pcf-dev/

Deployment types

The following deployments are currently supported 1) MSGW (Quickstart Startup Mode)

Configure variables:

The folder consists of manifest.yml file 1) manifest.yml file consist of docker image and all environment variable that are required to deploy microgateway

Deploy

• Accept the license

  To accept the license agreement [Microservices Gateway Pre-Release Agreement], set the value of "ACCEPT_LICENSE" to true. This variable is present in manifest.yml file.

Start PCFDev:

• This will take around 5 to 6 minutes

cf dev start

Login to PCFDev:

cf login -a api.local.pcfdev.io --skip-ssl-validation
Email> admin
Password> admin
press enter to skip

Create PCFDev 'org' and 'space' for hosting your application:

cf create-org <org-name>

cf target -o <org-name>

cf create-space <space-name>

cf target -o <org-name> -s <space-name>

Push microgateway application to PCFDev and create a tcp-route to it:

• cd to folder where manifest.yml file is present before pushing app to Cloud foundry

cf push microgateway

cf create-route <space-name> tcp.local.pcfdev.io --random-port

cf map-route microgateway tcp.local.pcfdev.io --port rport

• Where, rport is generated from previous step.

To check status of pushed app in PFCDev:

cf apps

To check logs:

cf logs microgateway --recent

To perform healthcheck of microgateway:

curl --insecure --user "admin:password" https://tcp.local.pcfdev.io:rport/sys/probe/healthcheck

If microgateway is up and running it returns:

OK

To scale microgateway:

cf scale microgateway -i <Number of instances>

To check instances is up and running:

cf apps

To see PCFDev application dashboard:

Go to URL: https://apps.local.pcfdev.io
Email> admin
Password> admin

Access QST endpoint from command line using curl:

curl --insecure --user "admin:password" https://tcp.local.pcfdev.io:rport/quickstart/1.0/services

Since, Microgateway doesn't have any publish service at this time, it should return an empty set:

[]

To publish a new service:

• To publish a new service you can embed them into your own custom docker image and creates new image that has your service . Change the name of docker image to name that you have given in manifest.yml file and push it again to Cloud foundry. For embeding the service into docker image follow link: https://docops.ca.com/ca-microgateway/1-0/EN/working-with-the-ca-microgateway/create-your-own-microgateway-image

curl --insecure --user "admin:password" https://tcp.local.pcfdev.io:rport/quickstart/1.0/services

It should return the service that you bake in docker image.