gitrepository_v1beta1.json

{
  "description": "GitRepository is the Schema for the gitrepositories API",
  "properties": {
    "apiVersion": {
      "description": "APIVersion defines the versioned schema of this representation of an object.\nServers should convert recognized schemas to the latest internal value, and\nmay reject unrecognized values.\nMore info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
      "type": "string"
    },
    "kind": {
      "description": "Kind is a string value representing the REST resource this object represents.\nServers may infer this from the endpoint the client submits requests to.\nCannot be updated.\nIn CamelCase.\nMore info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
      "type": "string"
    },
    "metadata": {
      "type": "object"
    },
    "spec": {
      "description": "GitRepositorySpec defines the desired state of a Git repository.",
      "properties": {
        "accessFrom": {
          "description": "AccessFrom defines an Access Control List for allowing cross-namespace references to this object.",
          "properties": {
            "namespaceSelectors": {
              "description": "NamespaceSelectors is the list of namespace selectors to which this ACL applies.\nItems in this list are evaluated using a logical OR operation.",
              "items": {
                "description": "NamespaceSelector selects the namespaces to which this ACL applies.\nAn empty map of MatchLabels matches all namespaces in a cluster.",
                "properties": {
                  "matchLabels": {
                    "additionalProperties": {
                      "type": "string"
                    },
                    "description": "MatchLabels is a map of {key,value} pairs. A single {key,value} in the matchLabels\nmap is equivalent to an element of matchExpressions, whose key field is \"key\", the\noperator is \"In\", and the values array contains only \"value\". The requirements are ANDed.",
                    "type": "object"
                  }
                },
                "type": "object",
                "additionalProperties": false
              },
              "type": "array"
            }
          },
          "required": [
            "namespaceSelectors"
          ],
          "type": "object",
          "additionalProperties": false
        },
        "gitImplementation": {
          "default": "go-git",
          "description": "Determines which git client library to use.\nDefaults to go-git, valid values are ('go-git', 'libgit2').",
          "enum": [
            "go-git",
            "libgit2"
          ],
          "type": "string"
        },
        "ignore": {
          "description": "Ignore overrides the set of excluded patterns in the .sourceignore format\n(which is the same as .gitignore). If not provided, a default will be used,\nconsult the documentation for your version to find out what those are.",
          "type": "string"
        },
        "include": {
          "description": "Extra git repositories to map into the repository",
          "items": {
            "description": "GitRepositoryInclude defines a source with a from and to path.",
            "properties": {
              "fromPath": {
                "description": "The path to copy contents from, defaults to the root directory.",
                "type": "string"
              },
              "repository": {
                "description": "Reference to a GitRepository to include.",
                "properties": {
                  "name": {
                    "description": "Name of the referent.",
                    "type": "string"
                  }
                },
                "required": [
                  "name"
                ],
                "type": "object",
                "additionalProperties": false
              },
              "toPath": {
                "description": "The path to copy contents to, defaults to the name of the source ref.",
                "type": "string"
              }
            },
            "required": [
              "repository"
            ],
            "type": "object",
            "additionalProperties": false
          },
          "type": "array"
        },
        "interval": {
          "description": "The interval at which to check for repository updates.",
          "type": "string"
        },
        "recurseSubmodules": {
          "description": "When enabled, after the clone is created, initializes all submodules within,\nusing their default settings.\nThis option is available only when using the 'go-git' GitImplementation.",
          "type": "boolean"
        },
        "ref": {
          "description": "The Git reference to checkout and monitor for changes, defaults to\nmaster branch.",
          "properties": {
            "branch": {
              "description": "The Git branch to checkout, defaults to master.",
              "type": "string"
            },
            "commit": {
              "description": "The Git commit SHA to checkout, if specified Tag filters will be ignored.",
              "type": "string"
            },
            "semver": {
              "description": "The Git tag semver expression, takes precedence over Tag.",
              "type": "string"
            },
            "tag": {
              "description": "The Git tag to checkout, takes precedence over Branch.",
              "type": "string"
            }
          },
          "type": "object",
          "additionalProperties": false
        },
        "secretRef": {
          "description": "The secret name containing the Git credentials.\nFor HTTPS repositories the secret must contain username and password\nfields.\nFor SSH repositories the secret must contain identity and known_hosts\nfields.",
          "properties": {
            "name": {
              "description": "Name of the referent.",
              "type": "string"
            }
          },
          "required": [
            "name"
          ],
          "type": "object",
          "additionalProperties": false
        },
        "suspend": {
          "description": "This flag tells the controller to suspend the reconciliation of this source.",
          "type": "boolean"
        },
        "timeout": {
          "default": "60s",
          "description": "The timeout for remote Git operations like cloning, defaults to 60s.",
          "type": "string"
        },
        "url": {
          "description": "The repository URL, can be a HTTP/S or SSH address.",
          "pattern": "^(http|https|ssh)://.*$",
          "type": "string"
        },
        "verify": {
          "description": "Verify OpenPGP signature for the Git commit HEAD points to.",
          "properties": {
            "mode": {
              "description": "Mode describes what git object should be verified, currently ('head').",
              "enum": [
                "head"
              ],
              "type": "string"
            },
            "secretRef": {
              "description": "The secret name containing the public keys of all trusted Git authors.",
              "properties": {
                "name": {
                  "description": "Name of the referent.",
                  "type": "string"
                }
              },
              "required": [
                "name"
              ],
              "type": "object",
              "additionalProperties": false
            }
          },
          "required": [
            "mode"
          ],
          "type": "object",
          "additionalProperties": false
        }
      },
      "required": [
        "interval",
        "url"
      ],
      "type": "object",
      "additionalProperties": false
    },
    "status": {
      "default": {
        "observedGeneration": -1
      },
      "description": "GitRepositoryStatus defines the observed state of a Git repository.",
      "properties": {
        "artifact": {
          "description": "Artifact represents the output of the last successful repository sync.",
          "properties": {
            "checksum": {
              "description": "Checksum is the SHA256 checksum of the artifact.",
              "type": "string"
            },
            "lastUpdateTime": {
              "description": "LastUpdateTime is the timestamp corresponding to the last update of this\nartifact.",
              "format": "date-time",
              "type": "string"
            },
            "path": {
              "description": "Path is the relative file path of this artifact.",
              "type": "string"
            },
            "revision": {
              "description": "Revision is a human readable identifier traceable in the origin source\nsystem. It can be a Git commit SHA, Git tag, a Helm index timestamp, a Helm\nchart version, etc.",
              "type": "string"
            },
            "url": {
              "description": "URL is the HTTP address of this artifact.",
              "type": "string"
            }
          },
          "required": [
            "path",
            "url"
          ],
          "type": "object",
          "additionalProperties": false
        },
        "conditions": {
          "description": "Conditions holds the conditions for the GitRepository.",
          "items": {
            "description": "Condition contains details for one aspect of the current state of this API Resource.\n---\nThis struct is intended for direct use as an array at the field path .status.conditions.  For example,\n\n\n\ttype FooStatus struct{\n\t    // Represents the observations of a foo's current state.\n\t    // Known .status.conditions.type are: \"Available\", \"Progressing\", and \"Degraded\"\n\t    // +patchMergeKey=type\n\t    // +patchStrategy=merge\n\t    // +listType=map\n\t    // +listMapKey=type\n\t    Conditions []metav1.Condition `json:\"conditions,omitempty\" patchStrategy:\"merge\" patchMergeKey:\"type\" protobuf:\"bytes,1,rep,name=conditions\"`\n\n\n\t    // other fields\n\t}",
            "properties": {
              "lastTransitionTime": {
                "description": "lastTransitionTime is the last time the condition transitioned from one status to another.\nThis should be when the underlying condition changed.  If that is not known, then using the time when the API field changed is acceptable.",
                "format": "date-time",
                "type": "string"
              },
              "message": {
                "description": "message is a human readable message indicating details about the transition.\nThis may be an empty string.",
                "maxLength": 32768,
                "type": "string"
              },
              "observedGeneration": {
                "description": "observedGeneration represents the .metadata.generation that the condition was set based upon.\nFor instance, if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration is 9, the condition is out of date\nwith respect to the current state of the instance.",
                "format": "int64",
                "minimum": 0,
                "type": "integer"
              },
              "reason": {
                "description": "reason contains a programmatic identifier indicating the reason for the condition's last transition.\nProducers of specific condition types may define expected values and meanings for this field,\nand whether the values are considered a guaranteed API.\nThe value should be a CamelCase string.\nThis field may not be empty.",
                "maxLength": 1024,
                "minLength": 1,
                "pattern": "^[A-Za-z]([A-Za-z0-9_,:]*[A-Za-z0-9_])?$",
                "type": "string"
              },
              "status": {
                "description": "status of the condition, one of True, False, Unknown.",
                "enum": [
                  "True",
                  "False",
                  "Unknown"
                ],
                "type": "string"
              },
              "type": {
                "description": "type of condition in CamelCase or in foo.example.com/CamelCase.\n---\nMany .condition.type values are consistent across resources like Available, but because arbitrary conditions can be\nuseful (see .node.status.conditions), the ability to deconflict is important.\nThe regex it matches is (dns1123SubdomainFmt/)?(qualifiedNameFmt)",
                "maxLength": 316,
                "pattern": "^([a-z0-9]([-a-z0-9]*[a-z0-9])?(\\.[a-z0-9]([-a-z0-9]*[a-z0-9])?)*/)?(([A-Za-z0-9][-A-Za-z0-9_.]*)?[A-Za-z0-9])$",
                "type": "string"
              }
            },
            "required": [
              "lastTransitionTime",
              "message",
              "reason",
              "status",
              "type"
            ],
            "type": "object",
            "additionalProperties": false
          },
          "type": "array"
        },
        "includedArtifacts": {
          "description": "IncludedArtifacts represents the included artifacts from the last successful repository sync.",
          "items": {
            "description": "Artifact represents the output of a source synchronisation.",
            "properties": {
              "checksum": {
                "description": "Checksum is the SHA256 checksum of the artifact.",
                "type": "string"
              },
              "lastUpdateTime": {
                "description": "LastUpdateTime is the timestamp corresponding to the last update of this\nartifact.",
                "format": "date-time",
                "type": "string"
              },
              "path": {
                "description": "Path is the relative file path of this artifact.",
                "type": "string"
              },
              "revision": {
                "description": "Revision is a human readable identifier traceable in the origin source\nsystem. It can be a Git commit SHA, Git tag, a Helm index timestamp, a Helm\nchart version, etc.",
                "type": "string"
              },
              "url": {
                "description": "URL is the HTTP address of this artifact.",
                "type": "string"
              }
            },
            "required": [
              "path",
              "url"
            ],
            "type": "object",
            "additionalProperties": false
          },
          "type": "array"
        },
        "lastHandledReconcileAt": {
          "description": "LastHandledReconcileAt holds the value of the most recent\nreconcile request value, so a change of the annotation value\ncan be detected.",
          "type": "string"
        },
        "observedGeneration": {
          "description": "ObservedGeneration is the last observed generation.",
          "format": "int64",
          "type": "integer"
        },
        "url": {
          "description": "URL is the download link for the artifact output of the last repository\nsync.",
          "type": "string"
        }
      },
      "type": "object",
      "additionalProperties": false
    }
  },
  "type": "object"
}