gcloud

When creating the custom image, either from a Google Cloud provided imageor an imported OS image, you must tag the OS image withIDPF. Use thegcloud compute images create commandas shown in the following example:

gcloud compute images createIMAGE_NAME \    --source-image=SOURCE_IMAGE \    --source-image-project=SOURCE_IMAGE_PROJECT \    --guest-os-features=IDPF

Replace the following:

• IMAGE_NAME: a name for the custom image.

• SOURCE_IMAGE: a specific OS image thatsupports IDPF, for example:sles-15-sp4-sap-v20240208-x86-64.

  If you want to use the latest OS image in animage family, replace the--source-image flag with the--source-image-family flag and setits value to an image family that supports IDPF, for example:--source-image-family=sles-15-sp4-sap.

• SOURCE_IMAGE_PROJECT: the name of the projectthat contains the source OS image or image family.

  Example

  To create a SUSE Linux Enterprise Server (SLES) OS image using thelatest OS image from the Compute Enginesles-15-sp5-sapimage family, run the following command:

  gcloud compute images create my-sles15sp5-metal-os \  --source-image-family=sles-15-sp5-sap \  --source-image-project=suse-sap-cloud \  --guest-os-features=IDPF

  For more information about when to use image families, seeImage family best practices.

REST

1. Select an OS image or image family that supports IDPFFor more information, seeOperating system details.

2. Using the OS image or image family selected in the previous step, createan OS image and tag this OS image withIDPF. To create the OS image,use theimages.insert method.

   POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/images{ "name":"IMAGE_NAME", "sourceImage":"SOURCE_IMAGE_URI", "guestOsFeatures":[  {     "type":"IDPF"   } ]}

   Replace the following:

   • IMAGE_NAME: a name for the custom image thatyou are creating.

   • SOURCE_IMAGE_URI: the URI for the specificOS image or image family that you want to use.

     For example:

     • Specific OS image:"sourceImage": "projects/suse-sap-cloud/global/images/sles-15-sp5-sap-v20240427-x86-64"
     • Image family:"sourceImage": "projects/suse-sap-cloud/global/images/family/sles-15-sp5-sap".

     When you specify an image family, Compute Engine creates a VMfrom the most recent, non-deprecated OS image in that family. Formore information about when to use image families, seeImage family best practices.

gcloud

1. Create the bare metal instance by using thegcloud compute instances create command.For the boot disk image, specify the custom OS image that you createdearlier. For the network interface, set the value of thenic-type flagtoIDPF.

   gcloud compute instances createINSTANCE_NAME \    --zone=ZONE \    --image=IMAGE_NAME \    --image-project=YOUR_IMAGE_PROJECT \    --network-interface=nic-type=IDPF

   Replace the following:

   • INSTANCE_NAME: a name for the new instance.
   • ZONE: the zone to create the instance in.
   • IMAGE_NAME: the custom OS image that wascreated previously.
   • YOUR_IMAGE_PROJECT: the name of the projectthat contains the custom OS image.

2. Optional: Verify that Compute Engine created the instance and that thenicType is set toIDPF.

   gcloud compute instances describeINSTANCE_NAME \   --zone=ZONE

   Replace the following:

   • INSTANCE_NAME: the name of the instance.
   • ZONE: the zone that you created the instance in.

   Example

   To create a bare metal instance in zoneeu-west4-b using a customizedSLES 15 SP5 for SAP OS image namedmy-sles15sp5-metal-os that's inprojectmy-project-12345, run the following command:

   gcloud compute instances createtest-x4-metal-custom-os \    --zone=eu-west4-b \    --machine-type=x4-1440-24t-metal \    --image=my-sles15sp5-metal-os \    --image-project=my-project-12345 \    --network-interface=nic-type=IDPF

   Things to consider

   The--network-interface flag has sub-level flags such as thefollowing:

   • --address: Assign an IP address to the instance
   • --network: The network the interface is to be a part of
   • --network-tier: The network tier of the interface
   • --subnet: The subnet that the interface is to be part of. If--network is also specified, the subnet must be a part of the specified network.
   • --private-network-ip: Specify the RFC 1918 IP to assign to theinstance.

   For a full list see, the--network-interface flag.

   Note: When enabling IDPF, if you need to set any of these sub-levelflags, you must specify these as a comma separated list to the--network-interface flag. For example,-network-interface=subnet=SUBNET_NAME,nic-type=IDPF.

REST

Create the bare metal instance by using theinstances.insert method.

• For the boot disk image, specify the custom OS image that you createdearlier.
• For the network interface, set the value of thenicType field toIDPF.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances{  "name":"INSTANCE_NAME",  "networkInterfaces":[    {      "nicType":"IDPF",      "network":"NETWORK",      "subnet":"SUBNET_NAME"    }  ],  "disks":[    {      "initializeParams":{        "sourceImage":"projects/YOUR_IMAGE_PROJECT/global/images/IMAGE_NAME"      },      "boot":true    }  ]}

Replace the following:

• PROJECT_ID: the ID of the project to createthe instance in.
• ZONE: the zone to create the instance in.
• INSTANCE_NAME: a name for the new instance.
• NETWORK: the URL of the network resource forthis instance. If neither the network nor the subnetwork is specified,the default networkglobal/networks/default is used.
• SUBNET_NAME: name of the subnet. The networkis inferred from the specified subnet. This is an optional field.
• YOUR_IMAGE_PROJECT: the name of your projectthat contains the OS image.
• IMAGE_NAME: the name of the custom OS imagethat was created in the previous step.