Skip to main content

GitLab Runner

General

The GitLabRunner is a read-only resource that provides status information about the claimed GitLab runner. While the GitLabRunnerClaim is used to request and set up a runner, the GitLabRunner reflects the current operational state of that runner within the system.

This clear distinction is essential to identify and understand potential runtime issues. For instance:

  • The runner's authentication token might be revoked or its permissions altered.
  • The connected GitLab instance's API could face interruptions or outages.
  • An update to the GitLab instance might introduce changes that affect the runner's operations.

By monitoring the status section of GitLabRunner resource, you can gain insights into these operational challenges and take appropriate action to ensure consistent pipeline job execution.

metadata section

The metadata section is used to uniquely identify objects and to provide other information that is not directly tied to a resource's configuration.

namespace: string

Namespace defines the space within which each GitLabRunner name must be unique.

name: string

Each GitLabRunner name must be unique, within a namespace. The name must contain only lower-case letters, digits and dashes.

More Details

In this section, we've described only two fields that are necessary and sufficient for users on Puzl. For a more in-depth explanation of metadata and its various fields, refer to the official Kubernetes documentation.

spec section

The section defines the desired state of the object. It describes the characteristics you want the resource to have: its configuration, settings, and data.

spec.runnerClaimRef

name
: string
Path:spec.runnerClaimRef.name

Name of the GitLabRunnerClaim resource initiated this GitLabRunner resource creation.

spec.manifestRef

name
: string
Path:spec.manifestRef.name

Internal system reference to the applied service manifest.

spec.releaseRef

Internal system reference to the runner release.

name
: string
Path:spec.releaseRef.name
namespace
: string
Path:spec.releaseRef.namespace
revision
: integer
Path:spec.releaseRef.revision
pipelineNamespaceRef
: string
Path:spec.pipelineNamespaceRef

status section

The section provides information about the current state of the object. It is populated by the platform and is used to inform users about the state of the resource, whether it's currently operational, and additional metadata like timestamps.

phase
: string
Default:Pending
Path:status.phase

Represents the high-level summary of the current status of the resource.

status.conditions[]

Conditions are designed based on Kubernetes API conventions. Conditions represent the logical states that the resource has passed through.

lastTransitionTime
: string
Path:status.conditions[].lastTransitionTime

The last time the condition transitioned from one status to another.

observedGeneration
: integer
Path:status.conditions[].observedGeneration

The value of metadata.generation when the condition has been transited last time.

message
: string
Path:status.conditions[].message

A human-readable message indicating details about the transition.

reason
: string
Path:status.conditions[].reason

A one-word, CamelCase reason caused the transition of the resource to this condition.

status
: string
Path:status.conditions[].status

The current status of the condition. Can be one of: True, False, or Unknown.

type
: string
Path:status.conditions[].type

Unique type of the resource condition.