Skip to main content

ClusterQueue

Resource ClusterQueue in pulumi-buildkite.
5 min read

Resource ClusterQueue in pulumi-buildkite.

Pulumi type: buildkite:index/clusterQueue:ClusterQueue.

name is the Pulumi resource name. Nested object fields are documented under that object. They are not arguments of this resource.

Example#

Only required arguments are set. A string in angle brackets stands in for that argument. Any other value is an option or example written in the SDK description.

Arguments#

PropertyTypeRequiredDescription
clusterIdstringyesThe ID of the cluster that this cluster queue belongs to.
descriptionstringnoA description for the cluster queue.
dispatchPausedbooleannoThe dispatch state of a cluster queue.
hostedAgentsClusterQueueHostedAgents (input)noControl the settings for the Buildkite hosted agents.
keystringyesThe key of the cluster queue.
retryAgentAffinitystringnoSpecifies which agent should be preferred when a job is retried. Valid values are prefer-warmest (prefer agents that have recently finished jobs) and prefer-different (prefer a different agent if available). Defaults to prefer-warmest.

Outputs#

Computed outputs are produced by the provider. They are not constructor arguments.

PropertyTypeComputedDescription
clusterIdstringnoThe ID of the cluster that this cluster queue belongs to.
clusterUuidstringyesThe UUID of the cluster this queue belongs to.
descriptionstringnoA description for the cluster queue.
dispatchPausedbooleannoThe dispatch state of a cluster queue.
hostedAgentsClusterQueueHostedAgents (output)noControl the settings for the Buildkite hosted agents.
keystringnoThe key of the cluster queue.
retryAgentAffinitystringnoSpecifies which agent should be preferred when a job is retried. Valid values are prefer-warmest (prefer agents that have recently finished jobs) and prefer-different (prefer a different agent if available). Defaults to prefer-warmest.
uuidstringyesThe UUID of the cluster queue.

ClusterQueueHostedAgents (input)#

Input object ClusterQueueHostedAgents. Fields below belong to this object, not to the parent.

PropertyTypeRequiredDescription
instanceShapestringyesThe instance shape to use for the Hosted Agent cluster queue. This can be a MacOS instance shape or a Linux instance shape. Valid values are: - MACOS_ARM64_M4_6X28 - MACOS_ARM64_M4_12X56 - LINUX_AMD64_2X4 - LINUX_AMD64_4X16 - LINUX_AMD64_8X32 - LINUX_AMD64_16X64 - LINUX_AMD64_32X128 - LINUX_AMD64_64X256 - LINUX_ARM64_2X4 - LINUX_ARM64_4X16 - LINUX_ARM64_8X32 - LINUX_ARM64_16X64 - LINUX_ARM64_32X128 - LINUX_ARM64_64X256
linuxClusterQueueHostedAgentsLinux (input)no
macClusterQueueHostedAgentsMac (input)no

ClusterQueueHostedAgentsLinux (input)#

Input object ClusterQueueHostedAgentsLinux. Fields below belong to this object, not to the parent.

PropertyTypeRequiredDescription
agentImageRefstringyesA URL reference to a container image that will be used for jobs running within the queue. This URL is required to be publicly available, or pushed to the internal registry available within the cluster. Please note that this value is currently experimental and in preview. Please contact support@buildkite.com to enable this functionality for your organization.

ClusterQueueHostedAgentsMac (input)#

Input object ClusterQueueHostedAgentsMac. Fields below belong to this object, not to the parent.

PropertyTypeRequiredDescription
macosVersionstringnoThe macOS version available to jobs in this queue. Buildkite selects the current default when this is omitted. This setting is experimental and may not work as expected.
xcodeVersionstringyesRequired selection of a specific XCode version to be selected for jobs in the queue to have available. Please note that this value is currently experimental and may not function as expected.

ClusterQueueHostedAgents (output)#

Output object ClusterQueueHostedAgents. Fields below belong to this object.

PropertyTypeAlways presentDescription
instanceShapestringyesThe instance shape to use for the Hosted Agent cluster queue. This can be a MacOS instance shape or a Linux instance shape. Valid values are: - MACOS_ARM64_M4_6X28 - MACOS_ARM64_M4_12X56 - LINUX_AMD64_2X4 - LINUX_AMD64_4X16 - LINUX_AMD64_8X32 - LINUX_AMD64_16X64 - LINUX_AMD64_32X128 - LINUX_AMD64_64X256 - LINUX_ARM64_2X4 - LINUX_ARM64_4X16 - LINUX_ARM64_8X32 - LINUX_ARM64_16X64 - LINUX_ARM64_32X128 - LINUX_ARM64_64X256
linuxClusterQueueHostedAgentsLinux (output)no
macClusterQueueHostedAgentsMac (output)no

ClusterQueueHostedAgentsLinux (output)#

Output object ClusterQueueHostedAgentsLinux. Fields below belong to this object.

PropertyTypeAlways presentDescription
agentImageRefstringyesA URL reference to a container image that will be used for jobs running within the queue. This URL is required to be publicly available, or pushed to the internal registry available within the cluster. Please note that this value is currently experimental and in preview. Please contact support@buildkite.com to enable this functionality for your organization.

ClusterQueueHostedAgentsMac (output)#

Output object ClusterQueueHostedAgentsMac. Fields below belong to this object.

PropertyTypeAlways presentDescription
macosVersionstringyesThe macOS version available to jobs in this queue. Buildkite selects the current default when this is omitted. This setting is experimental and may not work as expected.
xcodeVersionstringyesRequired selection of a specific XCode version to be selected for jobs in the queue to have available. Please note that this value is currently experimental and may not function as expected.