Publish Images

In this section we cover the steps to publish an OS image on Meneja and make it available for specific G8's

1- Create a Publisher

Step 1 In Meneja web interface select item Publishers in the menu on the left side to access the list of publishers.
Step 2 Select to create a new publisher
Step 3 Fill in the details on the image publisher and select SUBMIT

Result
A request to add a new publisher is sent to the GIG.tech administrators and waiting for their approval. Once it has been approved, you will be notified by email.

2- Create an Image

Step 1 In Meneja web interface select item Publishers in the menu on the left side to access the list of publishers.
Step 2 Select a publisher that you created in the previous step to open the publisher page.
Step 3 Select on the publisher page to publish a new image
Step 4 Fill in the image name and select the image type in the form and select SUBMIT.

Available images types are:

• Unix
• Linux
• Windows

Result A new image is published and ready to be used. The image should appear in the list of images on the publisher page.

In some cases it can be usefull to know the image ID. The ID can be extracted from the URL of the image page. To go to the image page, select the image from the list of images on the publisher page.

Example:
The URL of the image page is: https://meneja-qa.gig.tech/images/xx15f60c5ebfbd00014baxxx
Image ID from URL is the last part of the URL: xx15f60c5ebfbd00014baxxx

3- Getting version ID and the URL to upload the image to (via API )

Steps :

Go to https://meneja-qa.gig.tech/api/1/

POST /images/{image_id}/versions

Click try it Out button

1- Modify the Payload section as per following example:

  {
  "boot_type": "bios",  
  "build_information": {},
  "capabilities": {
    "add_disk": true,
    "add_memory": true,
    "add_nic": true,
    "add_vcpu": true,
    "remove_disk": true,
    "remove_nic": true,
    "remove_vcpu": true
  },
  "checksum": "f5608d4c46d921eed26df6c831d1c292",
  "label": "DUMMY",
  "requirements": {
    "boot_disk": 10,
    "memory": 512
  },
  "username": "Mohannad"
}

2- Add the Image ID which is obtained from step 2. Then click Execute

The aim of this step is to get the following info

-version ID.

-URL (s3 minIO) for uploading the image.

The output should be as following example

The version ID Is the following ID

"id": "5e15f8e75ebfbd00014ba364",

The upload URL is the following (in our example):

"upload_url": "https://storage-qa-meneja.gig.tech/vm-os-images/5e15c59d5ebfbd00014ba11b/5e15c60c5ebfbd00014ba179/5e15f8e75ebfbd00014ba364?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=meneja%2F20200108%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20200108T154439Z&X-Amz-Expires=604800&X-Amz-SignedHeaders=host&X-Amz-Signature=xxxxxxxxxxxx"
}

4- Uploading the OS Image to the generated upload URL

Try to use any software to upload the image, in our example, we used insomnia software:

https://support.insomnia.rest/article/23-installation#ubuntu

5- Mark the image as UPLOADED on meneja

In the same API page, use the following POST rest API .

POST /images/{image_id}/versions/{version_id}/uploaded

Meneja now starts tesing the image with a real VM test in the background. If all tests pass successfully then, the image is marked as READY and then it is exposed to Meneja.

Now , you should be able to view the OS image from meneja as follows

Ensure you can see:

-The Download button

-The label of (Current version) beside the image.

• Go to Meneja web interface > Image > select the image you uploaded > Click (+) ATTACH tab > Select the list of G8's that will have the new OS Image visible > select the account that will see the OS image visible.

Now you can see the list of the G8's that has this image visible

The OS image on the G8 is now in sync with the one published via Meneja.