Objective

The objective of this project is show you how to create an Edge microservice on your local developement machine using this demonstration starter-microservice

Definition of Terms

Important Installation Prerequisites

In order to create a microservice using mimik Edge, you must have a mimik Developer account. You can sign up for a mimik Developer account here: https://developer.mimik.com/console.

Once you've created a mimik Developer account, makes sure that Git, Node.js® and npm are installed on your development machine.

Then, you will need to install the following critically important items:

• mimik edgeEngine
• mimik edgeEngine CLI Tool

Also, you will need to create an Edge Access Token.

The following sections provide the information for installing the prerequisites.

Installing the mimik edgeEngine

You can find the various versions of edgeEngine at this URL: https://github.com/mimikgit/edgeSDK/releases. Select the artifact relevant to your development environment and the run the setup executable or uncompress the .tar file, depending on the targeted operating system.

After you have edgeEngine downloaded and installed, you need to get it up and running. You can find the instructions for installing and running the version of the mimik edgeEngine that is appropriate to your development machine at this URL: https://developer.mimik.com/installation-guide/.

Installing mimik edgeEngine CLI Tool

Once the mimik edgeEngine are installed, execute the following command to install the mimik edgeEngine CLI Tool.

npm install -g @mimik/mimik-edge-cli

Creating an Edge Access Token and binding it to your account

The last thing you'll need to to is create an Edge Access Token and bind it to your mimik account using the edgeEngine CLI Tool. The Edge Access Token makes the running instance of edgeEngine visible to other instances of edgeEngine running in the cluster.

You'll find the instructions for creating an Edge Access Token and binding it to your mimik account at this URL: https://developer.mimik.com/development-setup/.

Once all the prerequisites are satisfied you are ready to create the starter-microservice.

Build Process

The following steps will install the Node.js packages needed to create the the starter-microservice, build the microservice and then package it up in to a .tar file.

Step 1: Clone this repository onto your development machines.

git clone https://github.com/reselbob/starter-microservice.git

Step 2: Navigate into the newly cloned directory:

cd starter-microservice

Step 3: Install dependencies:

npm install

Step 4: Run the build script npm run build

Step 5: Package the built artifacts into the .tar file container:

npm run package

When you package the code for the starter-microservice, you'll get output similar to the following:

output: .generated-9vcmev9z77/repositories
output: .generated-9vcmev9z77/c9ebbb58695b4894964f67558e9aabad2bbf21bb542a9798e0453179bc139a3b/json
output: .generated-9vcmev9z77/c9ebbb58695b4894964f67558e9aabad2bbf21bb542a9798e0453179bc139a3b/VERSION
output: layer.tar
output: .generated-9vcmev9z77/bef09a33c835239d7cd812ccfc7b6a1a718126f4bc09cc596abdf5080b3ae364.json
output: .generated-9vcmev9z77/manifest.json
output: ./build/microservice-v1-1.0.0.tar

Pay special attention to the location of the generated .tar file for the starter-microservice, in this case...

./build/microservice-v1-1.0.0.tar

...you're going to use it.

Deploying the starter-microservice

Step 1: Run the following command in the same directory in which you generated the .tar file for the starter-microservice.

mimik-edge-cli image deploy --image={YOUR_IMAGE_PATH} --token={EDGE_ACCESS_TOKEN}

WHERE

• {YOUR_IMAGE_PATH} is the location of the generated .tar file created previously
• {EDGE_ACCESS_TOKEN} is the Edge Access Token that created previously in the section, Creating an Edge Access Token and binding it to your account above.

For example:

mimik-edge-cli image deploy \
  --image=build/microservice-v1-1.0.0.tar \
  --token=xxxiOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIyODE0MzA0ODA1MTkyNjAxNjAwIiwianRpIjoiaXBqS25DelJvaWN0dE5tR1FkVEVsZW5URn52VFxxxxxZCI6ImJiNmZiYTdkLTYzMjEtNDFjNS1hYzM3LTFhN2E4YTlhNGFjMCIsImF6cCI6IxxxxxxxxxFjNS1hYzM3LTFhN2E4YTlhNGFjMCIsImlzcyI6Imh0dHBzOi8vbWlkLm1pbWlrMzYwLmNvbS9tSUQvdjEvb2F1dGgvdG9rZW4iLCJub2RlX2lkIjoiZDE0YTAyOGMyYTNhMmJjOTQ3NjEwMmJiMjg4MjM0YzQxNWEyYjAxZjgyOGVhNjJXXXXmxxxxxxxxxx1pbWlrMzYwLmNvbS9tU1QvdjEvY2xpZW50cy9HZW5lcmljLWVkZ2UiXSwic2NvcGUiOiJvcGVuaWQgZWRnZTptY20gZWRnZTpjbHVzdGVycyBlZGdlOmFjY291bnQ6YXNzb2NpYXRlIGVkZ2U6YWNjb3VudDp1bmFzc29jaWF0ZSBlZGdlOnJlYWQ6YWNjb3VudGtleSIsImlhdCI6MTYyMDMzNzMwNCwiZXhwIjoxNjM1ODg5MzA0fQ.0IxkfUOWJ1fJJTZTBcxxxxxxxxx

Once microservice image is successfully deployed you should get a response that looks like this:

created: 1620339054
digest:  sha265:c8144df432f2c59834bc010be5ecc9764e0eda73d4d3fa036c34c4822684c707
id:      bb6fba7d-6321-41c5-ac37-1a7a8a9a4ac0-microservice-v1
name:    microservice-v1
size:    75206
status:  successfully deployed

Step 2: Open start.json in the source code working directory, starter-microservice

v1 start.json

You'll see the following:

{
  "name": "{{microserviceName}}",
  "image": "{{tarFileName}}",
  "env": {
    "MCM.BASE_API_PATH": "{{YOUR_API_PATH}}",
    "MCM.WEBSOCKET_SUPPORT": "true",
    "<add your environment variable name>": "{{add your environment variable}}"
  }
}

Step 3: Make substitutions in the file, start.json according the to out from the output shown above.

• Replace {{microserviceName}} with the name from the output, in this case: microservice-v1
• Replace {{tarFileName}} with the filename of the .tar file generated during the deployment process, in this case, microservice-v1-1.0.0.tar.
• Replace {{YOUR_API_PATH}} with a path of your choosing that will be appended to the host name to form the URL by which you will access the starter-microservice. We recommend keeping it simple, for example:

"MCM.BASE_API_PATH": "/sample/v1",

The JSON below shows an example of configurations settings for start.json:

{
  "name": "microservice-v1-1.0.0.tar",
  "image": "microservice-v1",
  "env": {
    "MCM.BASE_API_PATH": "/sample/v1",
    "MCM.WEBSOCKET_SUPPORT": "true"
  }
}

OPTIONAL: You can edit "add your environment variable name": "{{add your environment variable}}" to anything of your choosing related to your development environment. If you just want to get started for now, you can remove this line from start.json Read the source code for more information on custom environment variables.

Save the newly updated start.json file

Step 4: Navigate to where the start.json file is located then run the following command to deploy the starter-microservice payload:

mimik-edge-cli container deploy --payload start.json --token={EDGE_ACCESS_TOKEN}

In this case, you could run:

mimik-edge-cli container deploy --payload start.json \
--token=xxxiOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIyODE0MzA0ODA1MTkyNjAxNjAwIiwianRpIjoiaXBqS25DelJvaWN0dE5tR1FkVEVsZW5URn52VFxxxxxZCI6ImJiNmZiYTdkLTYzMjEtNDFjNS1hYzM3LTFhN2E4YTlhNGFjMCIsImF6cCI6IxxxxxxxxxFjNS1hYzM3LTFhN2E4YTlhNGFjMCIsImlzcyI6Imh0dHBzOi8vbWlkLm1pbWlrMzYwLmNvbS9tSUQvdjEvb2F1dGgvdG9rZW4iLCJub2RlX2lkIjoiZDE0YTAyOGMyYTNhMmJjOTQ3NjEwMmJiMjg4MjM0YzQxNWEyYjAxZjgyOGVhNjJXXXXmxxxxxxxxxx1pbWlrMzYwLmNvbS9tU1QvdjEvY2xpZW50cy9HZW5lcmljLWVkZ2UiXSwic2NvcGUiOiJvcGVuaWQgZWRnZTptY20gZWRnZTpjbHVzdGVycyBlZGdlOmFjY291bnQ6YXNzb2NpYXRlIGVkZ2U6YWNjb3VudDp1bmFzc29jaWF0ZSBlZGdlOnJlYWQ6YWNjb3VudGtleSIsImlhdCI6MTYyMDMzNzMwNCwiZXhwIjoxNjM1ODg5MzA0fQ.0IxkfUOWJ1fJJTZTBcxxxxxxxxx

You'll get output similar to the following:

created: 1620341668342
env: 
  MCM.BASE_API_PATH:     /bb6fba7d-6321-41c5-ac37-1a7a8a9a4ac0/sample/v1
  MCM.WEBSOCKET_SUPPORT: true
id:      bb6fba7d-6321-41c5-ac37-1a7a8a9a4ac0-microservice-v1-1.0.0.tar
image:   microservice-v1
imageId: bb6fba7d-6321-41c5-ac37-1a7a8a9a4ac0-microservice-v1
name:    microservice-v1-1.0.0.tar
state:   started

Step 5: Call the microservice, use the following format:

curl http://localhost:8083/< MCM.BASE_API_PATH>/

WHERE

< MCM.BASE_API_PATH> is the value resported in the response returned when you invoked the starter-microservice shown above previously. In this case the value is: /bb6fba7d-6321-41c5-ac37-1a7a8a9a4ac0/sample/v1/

Thus, to exercise the microservice, exe ut the following command:

curl http://localhost:8083/bb6fba7d-6321-41c5-ac37-1a7a8a9a4ac0/sample/v1/

You'll get out as follows:

Hello World

For more information and explanation, you can visit our mCM container management API references and general guide on packaging, deployment, and exporting microservice.