Caution: The master branch is under heavy development. Use releases instead of the master branch to get stable software.

Prerequisites 🔗︎

  • Logging operator requires Kubernetes v1.14.x or later.
  • For the Helm-based installation you need Helm v2.16.0 or later.

Deploy the Logging operator from Kubernetes Manifests 🔗︎

Complete the following steps to deploy the Logging operator using Kubernetes manifests. Alternatively, you can also install the operator using Helm.

  1. Create a controlNamespace called “logging”.

    kubectl create ns logging
    
  2. Create a ServiceAccount and install cluster roles.

    kubectl -n logging create -f https://raw.githubusercontent.com/banzaicloud/logging-operator-docs/master/docs/deploy/manifests/rbac.yaml
    
  3. Apply the ClusterResources.

    kubectl -n logging create -f https://raw.githubusercontent.com/banzaicloud/logging-operator/master/config/crd/bases/logging.banzaicloud.io_clusterflows.yaml
    kubectl -n logging create -f https://raw.githubusercontent.com/banzaicloud/logging-operator/master/config/crd/bases/logging.banzaicloud.io_clusteroutputs.yaml
    kubectl -n logging create -f https://raw.githubusercontent.com/banzaicloud/logging-operator/master/config/crd/bases/logging.banzaicloud.io_flows.yaml
    kubectl -n logging create -f https://raw.githubusercontent.com/banzaicloud/logging-operator/master/config/crd/bases/logging.banzaicloud.io_loggings.yaml
    kubectl -n logging create -f https://raw.githubusercontent.com/banzaicloud/logging-operator/master/config/crd/bases/logging.banzaicloud.io_outputs.yaml
    
  4. Deploy the Logging operator.

    kubectl -n logging create -f https://raw.githubusercontent.com/banzaicloud/logging-operator-docs/master/docs/deploy/manifests/deployment.yaml
    

Deploy Logging operator with Helm 🔗︎

Complete the following steps to deploy the Logging operator using Helm. Alternatively, you can also install the operator using Kubernetes manifests.

Note: For the Helm-based installation you need Helm v2.16.0 or later.

  1. Add operator chart repository.

    helm repo add banzaicloud-stable https://kubernetes-charts.banzaicloud.com
    helm repo update
    
  2. Install the Logging Operator

    • Helm v2

      helm install --namespace logging --name logging banzaicloud-stable/logging-operator
      
    • Helm v3

      kubectl create ns logging
      helm install --namespace logging logging banzaicloud-stable/logging-operator --set createCustomResource=false
      

      You can install the logging resource with built-in TLS generation using a Helm chart.

Check the Logging operator deployment 🔗︎

To verify that the installation was successful, complete the following steps.

  1. Check the status of the pods. You should see a new logging-operator pod.

    $ kubectl -n logging get pods
    NAME                                        READY   STATUS    RESTARTS   AGE
    logging-logging-operator-599c9cf846-5nw2n   1/1     Running   0          52s
    
  2. Check the CRDs. You should see the following five new CRDs.

    $  kubectl get crd
    NAME                                    CREATED AT
    clusterflows.logging.banzaicloud.io     2019-11-01T21:30:18Z
    clusteroutputs.logging.banzaicloud.io   2019-11-01T21:30:18Z
    flows.logging.banzaicloud.io            2019-11-01T21:30:18Z
    loggings.logging.banzaicloud.io         2019-11-01T21:30:18Z
    outputs.logging.banzaicloud.io          2019-11-01T21:30:18Z