36.5.2. Elasticsearch

다음 줄을 Ansible 인벤토리 파일에 추가하여 NFS 자동 프로비저닝 스토리지 클래스를 생성하고 백업 스토리지를 동적으로 프로비저닝합니다.

openshift_logging_es_pvc_storage_class_name=$nfsclass
openshift_logging_es_pvc_dynamic=true

다음 명령을 사용하여 로깅 플레이북을 사용하여 NFS 볼륨을 배포합니다.

ansible-playbook /usr/share/ansible/openshift-ansible/playbooks/openshift-logging/config.yml

다음 단계를 사용하여 PVC를 생성합니다.

Ansible 인벤토리 파일을 편집하여 NFS 볼륨을 구성하고 PVC 크기를 설정합니다.

openshift_logging_storage_kind=nfs
openshift_logging_storage_access_modes=['ReadWriteOnce']
openshift_logging_storage_nfs_directory=/share 1
openshift_logging_storage_nfs_options='*(rw,root_squash)' 2
openshift_logging_storage_labels={'storage': 'logging'}
openshift_logging_elasticsearch_storage_type=pvc
openshift_logging_es_pvc_size=10Gi
openshift_logging_es_pvc_storage_class_name=''
openshift_logging_es_pvc_dynamic=true
openshift_logging_es_pvc_prefix=logging

다음 명령을 사용하여 EFK 스택을 재배포합니다.

ansible-playbook /usr/share/ansible/openshift-ansible/playbooks/deploy_cluster.yml

관련 서비스 계정에 로컬 볼륨을 마운트하고 편집할 수 있는 권한이 있어야 합니다.

  $ oc adm policy add-scc-to-user privileged  \
         system:serviceaccount:openshift-logging:aggregated-logging-elasticsearch

예를 들면 다음과 같은 권한을 클레임하려면 각 Elasticsearch 노드 정의를 패치해야 합니다.

$ for dc in $(oc get deploymentconfig --selector component=es -o name); do
    oc scale $dc --replicas=0
    oc patch $dc \
       -p '{"spec":{"template":{"spec":{"containers":[{"name":"elasticsearch","securityContext":{"privileged": true}}]}}}}'
  done

로컬 Elasticsearch 스토리지의 각 인프라 노드에 로컬 마운트 지점을 생성합니다.

$ mkdir /usr/local/es-storage

Elasticsearch 볼륨에서 파일 시스템을 생성합니다.

$ mkfs.ext4 /dev/xxx

elasticsearch 볼륨을 마운트합니다.

$ mount /dev/xxx /usr/local/es-storage

/etc/fstab 에 다음 행을 추가합니다.

$ /dev/xxx /usr/local/es-storage ext4

마운트 지점의 소유권을 변경합니다.

$ chown 1000:1000 /usr/local/es-storage

관련 서비스 계정에 로컬 볼륨을 마운트하고 편집할 권한을 부여합니다.

  $ oc adm policy add-scc-to-user privileged  \
         system:serviceaccount:openshift-logging:aggregated-logging-elasticsearch

권한을 요청하려면 예제에 표시된 대로 Ops 클러스터에 --selector 구성 요소=es-ops 를 지정하는 각 Elasticsearch 복제본 정의를 패치합니다.

  $ for dc in $(oc get deploymentconfig --selector component=es -o name);
do
    oc scale $dc --replicas=0
    oc patch $dc \
       -p '{"spec":{"template":{"spec":{"containers":[{"name":"elasticsearch","securityContext":{"privileged":
true}}]}}}}'
done

올바른 노드에서 Elasticsearch 복제본을 찾아 로컬 스토리지를 사용하고 해당 노드가 일정 시간 동안 중단되는 경우에도 해당 복제본을 이동하지 않습니다. 노드 위치를 지정하려면 각 Elasticsearch 복제본에 관리자가 스토리지를 할당한 노드에 고유한 노드 선택기를 지정합니다.

노드 선택기를 구성하려면 각 Elasticsearch 배포 구성을 편집하거나 nodeSelector 섹션을 추가하거나 편집하여 원하는 각 노드에 적용한 고유한 라벨을 지정합니다.

apiVersion: v1
kind: DeploymentConfig
spec:
  template:
    spec:
      nodeSelector:
        logging-es-node: "1"

레이블은 해당 레이블이 있는 단일 노드(이 경우 logging-es-node=1 )를 통해 복제본을 고유하게 식별해야 합니다.

각 필수 노드에 대한 노드 선택기를 생성합니다. oc label 명령을 사용하여 필요한 수의 노드에 레이블을 적용합니다.

예를 들어 배포에 세 개의 인프라 노드가 있는 경우 다음과 같이 해당 노드의 레이블을 추가할 수 있습니다.

  $ oc label node <nodename1> logging-es-node=0
  $ oc label node <nodename2> logging-es-node=1
  $ oc label node <nodename3> logging-es-node=2

노드 선택기의 애플리케이션을 자동화하려면 다음과 같이 oc label 명령 대신 oc patch 명령을 사용합니다.

  $ oc patch dc/logging-es-<suffix> \
     -p '{"spec":{"template":{"spec":{"nodeSelector":{"logging-es-node":"1"}}}}}'

이러한 단계를 완료하고 나면 각 복제본에 로컬 호스트 마운트를 적용할 수 있습니다. 다음 예제에서는 스토리지가 각 노드의 동일한 경로에 마운트된 것으로 가정하고 Ops 클러스터에 대해 --selector component=es-ops 를 지정합니다.

$ for dc in $(oc get deploymentconfig --selector component=es -o name);
do
    oc set volume $dc \
          --add --overwrite --name=elasticsearch-storage \
          --type=hostPath --path=/usr/local/es-storage
    oc rollout latest $dc
    oc scale $dc --replicas=1
done

Elasticsearch를 재암호화 경로로 액세스하려면 다음 변수를 정의합니다.

openshift_logging_es_allow_external=True
openshift_logging_es_hostname=elasticsearch.example.com

플레이북 디렉터리로 변경하고 다음 Ansible 플레이북을 실행합니다.

$ cd /usr/share/ansible/openshift-ansible
$ ansible-playbook [-i </path/to/inventory>] \
    playbooks/openshift-logging/config.yml

Elasticsearch에 원격으로 로그인하려면 요청에 세 개의 HTTP 헤더가 포함되어야 합니다.

Authorization: Bearer $token
X-Proxy-Remote-User: $username
X-Forwarded-For: $ip_address

로그에 액세스하려면 프로젝트에 액세스할 수 있어야 합니다. 예를 들면 다음과 같습니다.

$ oc login <user1>
$ oc new-project <user1project>
$ oc new-app <httpd-example>

요청에 사용할 이 ServiceAccount의 토큰을 가져와야 합니다.

$ token=$(oc whoami -t)

이전에 구성된 토큰을 사용하여 노출된 경로를 통해 Elasticsearch에 액세스할 수 있어야 합니다.

$ curl -k -H "Authorization: Bearer $token" -H "X-Proxy-Remote-User: $(oc whoami)" -H "X-Forwarded-For: 127.0.0.1" https://es.example.test/project.my-project.*/_search?q=level:err | python -mjson.tool