You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/cyclecloud/how-to/create-custom-image.md
+10-10Lines changed: 10 additions & 10 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -7,7 +7,7 @@ ms.author: adjohnso
7
7
---
8
8
# Custom Images in a CycleCloud Cluster
9
9
10
-
An Azure CycleCloud installation uses recommended OS images for clusters by default, but the use of Azure Marketplace images, Gallery images (in preview) or custom images in nodes and nodearrays is also supported. Custom images are useful for pre-installed applications in a cluster, or to fulfill business or security requirements.
10
+
An Azure CycleCloud installation uses recommended OS images for clusters by default, but the use of Azure Marketplace images, Gallery images (in preview) or custom images in nodes and nodearrays is also supported. Custom images are useful for preinstalled applications in a cluster, or to fulfill business or security requirements.
11
11
12
12
## Specify a Custom Image via the Cluster UI
13
13
@@ -16,7 +16,7 @@ Custom and marketplace images are supported in the cluster UI. Instead of select
> This is only supported in CycleCloud versions >7.7.0
19
+
> Customer Image is supported only in CycleCloud versions later than 7.7.0.
20
20
21
21
## Use a Custom Image in a CycleCloud Template
22
22
@@ -41,11 +41,11 @@ You can also specify a Marketplace or Gallery image by using the URN:
41
41
```
42
42
43
43
> [!NOTE]
44
-
> CycleCloud versions prior to 7.7.0 [require a different notation](#custom-image-notation-prior-7-7-0).
44
+
> CycleCloud versions earlier than 7.7.0 [require a different notation](#custom-image-notation-prior-7-7-0).
45
45
46
46
### Use an Azure Marketplace Image with a Pricing Plan
47
47
48
-
You can use a Marketplace image with an associated pricing plan but the image must be enabled for programmatic use. To do this, locate the Marketplace image you want to use. Click **Want to deploy programmatically**, **Get Started ->**, and enter any required information and save it.
48
+
You can use a Marketplace image with an associated pricing plan but the image must be enabled for programmatic use. To complete this process, locate the desired image in the Marketplace, click **Want to deploy programmatically**, then select **Get Started ->**, fill in the required information, and save your changes.
49
49
50
50
::: moniker range=">=cyclecloud-8"
51
51
To enable CycleCloud to automatically accept license terms on your behalf, enable the "Accept marketplace terms on my behalf" option on your subscription in the web interface:
@@ -67,7 +67,7 @@ az vm image accept-terms --publisher PUBLISHER --offer OFFER --plan SKU
67
67
68
68
### Use a Shared Image Gallery image with a Pricing Plan
69
69
70
-
CycleCloud 8.0.2 and up support custom images created from images with a pricing plan. This requires using a custom template:
70
+
Starting with CycleCloud version 8.0.2, custom images derived from those with a pricing plan are supported. This functionality requires the use of a custom template:
71
71
72
72
```ini
73
73
[[node custom_image]]
@@ -78,23 +78,23 @@ CycleCloud 8.0.2 and up support custom images created from images with a pricing
78
78
ImagePlan.Name = NAME (sometimes called SKU)
79
79
```
80
80
81
-
If the Shared Image Gallery has the purchase-plan metadata on it, it is used automatically and you do not need to specify the plan details.
81
+
If the Shared Image Gallery has the purchase-plan metadata on it, it's used automatically and you don't need to specify the plan details.
82
82
83
83
## Create a Custom Image
84
84
85
85
Custom Azure Images can be created by following [this tutorial.](/azure/virtual-machines/image-version-vm-cli#create-an-image-definition)
86
86
87
87
> [!NOTE]
88
-
> Please use generalized images since specialized images have not been through the process to remove machinespecific information and accounts, and specialized images do not contain osProfile which CycleCloud requires.
88
+
> Generalized images have been recommended, as specialized images haven't undergone the process to remove machine-specific information and accounts, and they lack the osProfile required by CycleCloud.
89
89
90
90
<aname="custom-image-notation-prior-7-7-0"></a>
91
-
## Custom Images on prior CycleCloud versions (<7.7.0)
91
+
## Custom Images on CycleCloud versions earlier than 7.7.0
92
92
93
-
Custom and marketplace images are supported in CycleCloud versions prior to 7.7.0 but they use a different notation. To use a custom image in a CycleCloud template prior to version 7.7.0, the `ImageId` attribute is used to specify the custom Azure image. This ID can be found in the Azure portal as the Resource ID for the image, and generally takes the form:
93
+
Custom and marketplace images are supported in CycleCloud versions earlier than 7.7.0 but they use a different notation. To use a custom image in a CycleCloud template earlier than version 7.7.0, the `ImageId` attribute is used to specify the custom Azure image. This ID can be found in the Azure portal as the Resource ID for the image, and generally takes the form:
Marketplace images prior to version 7.7.0 need to be specified using their Publisher/Offer/Sku/Version explicitly. They also need to specify `JetpackPlatform`so the correct jetpack packages is installed. Acceptable values for `JetpackPlatform`are:`centos-6`,`centos-7`, `ubuntu-14.04`, `ubuntu-16.04`, and `windows`. This should match the operating system of the Azure Marketplace image. Additionally,`InstallJetpack` must be set to true.
97
+
For CycleCloud versions earlier than 7.7.0, Marketplace images must be specified explicitly using their Publisher, Offer, SKU, and Version. Also, the `JetpackPlatform`attribute must be defined to ensure the correct Jetpack packages are installed. Accepted values for `JetpackPlatform`include`centos-6`,`centos-7`, `ubuntu-14.04`, `ubuntu-16.04`, and `windows`, and this should align with the operating system of the Azure Marketplace image. The`InstallJetpack` must also be set to true.
0 commit comments