Package Management

The Humio Operator can manage LogScale packages through two resources: HumioPackageRegistry configures access to a package repository, and HumioPackage manages the installation of packages from a configured registry.

HumioPackageRegistry

A HumioPackageRegistry resource configures access to external package repositories. It supports multiple registry types including GitHub, GitLab, AWS S3, Google Cloud Storage, JFrog Artifactory, and LogScale Marketplace.

yaml
apiVersion: core.humio.com/v1alpha1
kind: HumioPackageRegistry
metadata:
  name: github-packages
spec:
  managedClusterName: example-humiocluster
  name: "github-packages"
  type: "github"
  githubConfig:
    organization: "my-org"
    repository: "humio-packages"
    path: "packages"
    branch: "main"
    credentials:
      secretKeyRef:
        name: "github-token-secret"
        key: "token"

Supported registry types include:

  • github: GitHub repositories with optional authentication

  • gitlab: GitLab repositories with API token authentication

  • aws: AWS S3 buckets with IAM or credential-based access

  • gcloud: Google Cloud Storage buckets

  • artifactory: JFrog Artifactory repositories

  • marketplace: LogScale Marketplace (public packages)

HumioPackage

A HumioPackage resource manages the installation and configuration of packages from configured registries. It enables automated deployment of LogScale packages such as parsers, dashboards, and queries.

yaml
apiVersion: core.humio.com/v1alpha1
kind: HumioPackage
metadata:
  name: apache-log-parser
spec:
  managedClusterName: example-humiocluster
  name: "apache-log-parser"
  viewName: "logs"
  registryName: "github-packages"
  packageId: "apache/apache-access-logs"
  version: "1.2.3"
  autoUpdate: false
  installationParameters:
    field_mapping:
      timestamp_field: "@timestamp"
      source_field: "host"

Packages can be configured with installation parameters specific to the package type and can optionally be set to automatically update when new versions are available in the registry.