public static final class GuestPolicies.SoftwareRecipe extends GeneratedMessageV3 implements GuestPolicies.SoftwareRecipeOrBuilder
A software recipe is a set of instructions for installing and configuring a
piece of software. It consists of a set of artifacts that are
downloaded, and a set of steps that install, configure, and/or update the
software.
Recipes support installing and updating software from artifacts in the
following formats:
Zip archive, Tar archive, Windows MSI, Debian package, and RPM package.
Additionally, recipes support executing a script (either defined in a file or
directly in this api) in bash, sh, cmd, and powershell.
Updating a software recipe
If a recipe is assigned to an instance and there is a recipe with the same
name but a lower version already installed and the assigned state
of the recipe is UPDATED
, then the recipe is updated to
the new version.
Script Working Directories
Each script or execution step is run in its own temporary directory which
is deleted after completing the step.
Protobuf type google.cloud.osconfig.v1beta.SoftwareRecipe
Static Fields
ARTIFACTS_FIELD_NUMBER
public static final int ARTIFACTS_FIELD_NUMBER
Field Value
DESIRED_STATE_FIELD_NUMBER
public static final int DESIRED_STATE_FIELD_NUMBER
Field Value
INSTALL_STEPS_FIELD_NUMBER
public static final int INSTALL_STEPS_FIELD_NUMBER
Field Value
NAME_FIELD_NUMBER
public static final int NAME_FIELD_NUMBER
Field Value
UPDATE_STEPS_FIELD_NUMBER
public static final int UPDATE_STEPS_FIELD_NUMBER
Field Value
VERSION_FIELD_NUMBER
public static final int VERSION_FIELD_NUMBER
Field Value
Static Methods
getDefaultInstance()
public static GuestPolicies.SoftwareRecipe getDefaultInstance()
Returns
getDescriptor()
public static final Descriptors.Descriptor getDescriptor()
Returns
newBuilder()
public static GuestPolicies.SoftwareRecipe.Builder newBuilder()
Returns
newBuilder(GuestPolicies.SoftwareRecipe prototype)
public static GuestPolicies.SoftwareRecipe.Builder newBuilder(GuestPolicies.SoftwareRecipe prototype)
Parameter
Returns
public static GuestPolicies.SoftwareRecipe parseDelimitedFrom(InputStream input)
Parameter
Returns
Exceptions
public static GuestPolicies.SoftwareRecipe parseDelimitedFrom(InputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
Returns
Exceptions
parseFrom(byte[] data)
public static GuestPolicies.SoftwareRecipe parseFrom(byte[] data)
Parameter
Name | Description |
data | byte[]
|
Returns
Exceptions
parseFrom(byte[] data, ExtensionRegistryLite extensionRegistry)
public static GuestPolicies.SoftwareRecipe parseFrom(byte[] data, ExtensionRegistryLite extensionRegistry)
Parameters
Returns
Exceptions
parseFrom(ByteString data)
public static GuestPolicies.SoftwareRecipe parseFrom(ByteString data)
Parameter
Returns
Exceptions
parseFrom(ByteString data, ExtensionRegistryLite extensionRegistry)
public static GuestPolicies.SoftwareRecipe parseFrom(ByteString data, ExtensionRegistryLite extensionRegistry)
Parameters
Returns
Exceptions
public static GuestPolicies.SoftwareRecipe parseFrom(CodedInputStream input)
Parameter
Returns
Exceptions
public static GuestPolicies.SoftwareRecipe parseFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
Returns
Exceptions
public static GuestPolicies.SoftwareRecipe parseFrom(InputStream input)
Parameter
Returns
Exceptions
public static GuestPolicies.SoftwareRecipe parseFrom(InputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
Returns
Exceptions
parseFrom(ByteBuffer data)
public static GuestPolicies.SoftwareRecipe parseFrom(ByteBuffer data)
Parameter
Returns
Exceptions
parseFrom(ByteBuffer data, ExtensionRegistryLite extensionRegistry)
public static GuestPolicies.SoftwareRecipe parseFrom(ByteBuffer data, ExtensionRegistryLite extensionRegistry)
Parameters
Returns
Exceptions
parser()
public static Parser<GuestPolicies.SoftwareRecipe> parser()
Returns
Methods
equals(Object obj)
public boolean equals(Object obj)
Parameter
Returns
Overrides
getArtifacts(int index)
public GuestPolicies.SoftwareRecipe.Artifact getArtifacts(int index)
Resources available to be used in the steps in the recipe.
repeated .google.cloud.osconfig.v1beta.SoftwareRecipe.Artifact artifacts = 3;
Parameter
Returns
getArtifactsCount()
public int getArtifactsCount()
Resources available to be used in the steps in the recipe.
repeated .google.cloud.osconfig.v1beta.SoftwareRecipe.Artifact artifacts = 3;
Returns
getArtifactsList()
public List<GuestPolicies.SoftwareRecipe.Artifact> getArtifactsList()
Resources available to be used in the steps in the recipe.
repeated .google.cloud.osconfig.v1beta.SoftwareRecipe.Artifact artifacts = 3;
Returns
getArtifactsOrBuilder(int index)
public GuestPolicies.SoftwareRecipe.ArtifactOrBuilder getArtifactsOrBuilder(int index)
Resources available to be used in the steps in the recipe.
repeated .google.cloud.osconfig.v1beta.SoftwareRecipe.Artifact artifacts = 3;
Parameter
Returns
getArtifactsOrBuilderList()
public List<? extends GuestPolicies.SoftwareRecipe.ArtifactOrBuilder> getArtifactsOrBuilderList()
Resources available to be used in the steps in the recipe.
repeated .google.cloud.osconfig.v1beta.SoftwareRecipe.Artifact artifacts = 3;
Returns
Type | Description |
List<? extends com.google.cloud.osconfig.v1beta.GuestPolicies.SoftwareRecipe.ArtifactOrBuilder> | |
getDefaultInstanceForType()
public GuestPolicies.SoftwareRecipe getDefaultInstanceForType()
Returns
getDesiredState()
public GuestPolicies.DesiredState getDesiredState()
Default is INSTALLED. The desired state the agent should maintain for this
recipe.
INSTALLED: The software recipe is installed on the instance but
won't be updated to new versions.
UPDATED: The software recipe is installed on the instance. The recipe is
updated to a higher version, if a higher version of the recipe is
assigned to this instance.
REMOVE: Remove is unsupported for software recipes and attempts to
create or update a recipe to the REMOVE state is rejected.
.google.cloud.osconfig.v1beta.DesiredState desired_state = 6;
Returns
getDesiredStateValue()
public int getDesiredStateValue()
Default is INSTALLED. The desired state the agent should maintain for this
recipe.
INSTALLED: The software recipe is installed on the instance but
won't be updated to new versions.
UPDATED: The software recipe is installed on the instance. The recipe is
updated to a higher version, if a higher version of the recipe is
assigned to this instance.
REMOVE: Remove is unsupported for software recipes and attempts to
create or update a recipe to the REMOVE state is rejected.
.google.cloud.osconfig.v1beta.DesiredState desired_state = 6;
Returns
Type | Description |
int | The enum numeric value on the wire for desiredState.
|
getInstallSteps(int index)
public GuestPolicies.SoftwareRecipe.Step getInstallSteps(int index)
Actions to be taken for installing this recipe. On failure it stops
executing steps and does not attempt another installation. Any steps taken
(including partially completed steps) are not rolled back.
repeated .google.cloud.osconfig.v1beta.SoftwareRecipe.Step install_steps = 4;
Parameter
Returns
getInstallStepsCount()
public int getInstallStepsCount()
Actions to be taken for installing this recipe. On failure it stops
executing steps and does not attempt another installation. Any steps taken
(including partially completed steps) are not rolled back.
repeated .google.cloud.osconfig.v1beta.SoftwareRecipe.Step install_steps = 4;
Returns
getInstallStepsList()
public List<GuestPolicies.SoftwareRecipe.Step> getInstallStepsList()
Actions to be taken for installing this recipe. On failure it stops
executing steps and does not attempt another installation. Any steps taken
(including partially completed steps) are not rolled back.
repeated .google.cloud.osconfig.v1beta.SoftwareRecipe.Step install_steps = 4;
Returns
getInstallStepsOrBuilder(int index)
public GuestPolicies.SoftwareRecipe.StepOrBuilder getInstallStepsOrBuilder(int index)
Actions to be taken for installing this recipe. On failure it stops
executing steps and does not attempt another installation. Any steps taken
(including partially completed steps) are not rolled back.
repeated .google.cloud.osconfig.v1beta.SoftwareRecipe.Step install_steps = 4;
Parameter
Returns
getInstallStepsOrBuilderList()
public List<? extends GuestPolicies.SoftwareRecipe.StepOrBuilder> getInstallStepsOrBuilderList()
Actions to be taken for installing this recipe. On failure it stops
executing steps and does not attempt another installation. Any steps taken
(including partially completed steps) are not rolled back.
repeated .google.cloud.osconfig.v1beta.SoftwareRecipe.Step install_steps = 4;
Returns
Type | Description |
List<? extends com.google.cloud.osconfig.v1beta.GuestPolicies.SoftwareRecipe.StepOrBuilder> | |
getName()
Required. Unique identifier for the recipe. Only one recipe with a given name is
installed on an instance.
Names are also used to identify resources which helps to determine whether
guest policies have conflicts. This means that requests to create multiple
recipes with the same name and version are rejected since they
could potentially have conflicting assignments.
string name = 1 [(.google.api.field_behavior) = REQUIRED];
Returns
Type | Description |
String | The name.
|
getNameBytes()
public ByteString getNameBytes()
Required. Unique identifier for the recipe. Only one recipe with a given name is
installed on an instance.
Names are also used to identify resources which helps to determine whether
guest policies have conflicts. This means that requests to create multiple
recipes with the same name and version are rejected since they
could potentially have conflicting assignments.
string name = 1 [(.google.api.field_behavior) = REQUIRED];
Returns
getParserForType()
public Parser<GuestPolicies.SoftwareRecipe> getParserForType()
Returns
Overrides
getSerializedSize()
public int getSerializedSize()
Returns
Overrides
getUnknownFields()
public final UnknownFieldSet getUnknownFields()
Returns
Overrides
getUpdateSteps(int index)
public GuestPolicies.SoftwareRecipe.Step getUpdateSteps(int index)
Actions to be taken for updating this recipe. On failure it stops
executing steps and does not attempt another update for this recipe. Any
steps taken (including partially completed steps) are not rolled back.
repeated .google.cloud.osconfig.v1beta.SoftwareRecipe.Step update_steps = 5;
Parameter
Returns
getUpdateStepsCount()
public int getUpdateStepsCount()
Actions to be taken for updating this recipe. On failure it stops
executing steps and does not attempt another update for this recipe. Any
steps taken (including partially completed steps) are not rolled back.
repeated .google.cloud.osconfig.v1beta.SoftwareRecipe.Step update_steps = 5;
Returns
getUpdateStepsList()
public List<GuestPolicies.SoftwareRecipe.Step> getUpdateStepsList()
Actions to be taken for updating this recipe. On failure it stops
executing steps and does not attempt another update for this recipe. Any
steps taken (including partially completed steps) are not rolled back.
repeated .google.cloud.osconfig.v1beta.SoftwareRecipe.Step update_steps = 5;
Returns
getUpdateStepsOrBuilder(int index)
public GuestPolicies.SoftwareRecipe.StepOrBuilder getUpdateStepsOrBuilder(int index)
Actions to be taken for updating this recipe. On failure it stops
executing steps and does not attempt another update for this recipe. Any
steps taken (including partially completed steps) are not rolled back.
repeated .google.cloud.osconfig.v1beta.SoftwareRecipe.Step update_steps = 5;
Parameter
Returns
getUpdateStepsOrBuilderList()
public List<? extends GuestPolicies.SoftwareRecipe.StepOrBuilder> getUpdateStepsOrBuilderList()
Actions to be taken for updating this recipe. On failure it stops
executing steps and does not attempt another update for this recipe. Any
steps taken (including partially completed steps) are not rolled back.
repeated .google.cloud.osconfig.v1beta.SoftwareRecipe.Step update_steps = 5;
Returns
Type | Description |
List<? extends com.google.cloud.osconfig.v1beta.GuestPolicies.SoftwareRecipe.StepOrBuilder> | |
getVersion()
public String getVersion()
The version of this software recipe. Version can be up to 4 period
separated numbers (e.g. 12.34.56.78).
string version = 2;
Returns
Type | Description |
String | The version.
|
getVersionBytes()
public ByteString getVersionBytes()
The version of this software recipe. Version can be up to 4 period
separated numbers (e.g. 12.34.56.78).
string version = 2;
Returns
hashCode()
Returns
Overrides
internalGetFieldAccessorTable()
protected GeneratedMessageV3.FieldAccessorTable internalGetFieldAccessorTable()
Returns
Overrides
isInitialized()
public final boolean isInitialized()
Returns
Overrides
newBuilderForType()
public GuestPolicies.SoftwareRecipe.Builder newBuilderForType()
Returns
newBuilderForType(GeneratedMessageV3.BuilderParent parent)
protected GuestPolicies.SoftwareRecipe.Builder newBuilderForType(GeneratedMessageV3.BuilderParent parent)
Parameter
Returns
Overrides
newInstance(GeneratedMessageV3.UnusedPrivateParameter unused)
protected Object newInstance(GeneratedMessageV3.UnusedPrivateParameter unused)
Parameter
Returns
Overrides
toBuilder()
public GuestPolicies.SoftwareRecipe.Builder toBuilder()
Returns
writeTo(CodedOutputStream output)
public void writeTo(CodedOutputStream output)
Parameter
Overrides
Exceptions