우리는 이미 이야기했습니다. 타란툴 카트리지, 분산 애플리케이션을 개발하고 패키징할 수 있습니다. 아무것도 남지 않았습니다. 이러한 애플리케이션을 배포하고 관리하는 방법을 알아보세요. 걱정하지 마세요. 우리는 모든 것을 고려했습니다! 우리는 Tarantool Cartridge 작업에 대한 모든 모범 사례를 모아서 작성했습니다. 가능한 역할패키지를 서버로 분해하고, 인스턴스를 시작하고, 클러스터로 통합하고, 인증을 구성하고, vshard를 부트스트랩하고, 자동 장애 조치를 활성화하고, 클러스터 구성을 패치합니다.

흥미로운? 그런 다음 컷 아래에 물어 보면 모든 것을 말하고 보여줄 것입니다.

예부터 시작해 보겠습니다.

우리는 역할의 기능 중 일부만 다룰 것입니다. 모든 기능과 입력 매개변수에 대한 전체 설명은 언제든지 다음에서 확인할 수 있습니다. 선적 서류 비치. 하지만 백 번 보는 것보다 한 번 시도해 보는 것이 더 낫기 때문에 작은 애플리케이션을 배포해 보겠습니다.

Tarantool 카트리지에는 지도 시간 은행 고객 및 계좌에 대한 정보를 저장하고 HTTP를 통해 데이터를 관리하기 위한 API를 제공하는 작은 카트리지 애플리케이션을 생성합니다. 이를 위해 애플리케이션은 두 가지 가능한 역할을 설명합니다. api и storage인스턴스에 할당할 수 있습니다.

카트리지 자체는 프로세스를 시작하는 방법에 대해 아무 말도 하지 않으며 이미 실행 중인 인스턴스를 구성하는 기능만 제공합니다. 구성 파일 분해, 서비스 시작, 토폴로지 설정 등 나머지 작업은 사용자가 직접 수행해야 합니다. 하지만 우리는 이 모든 작업을 수행하지 않을 것이며 Ansible이 우리를 위해 이를 수행할 것입니다.

증서에서 행동으로

이제 애플리케이션을 두 개의 가상 머신에 배포하고 간단한 토폴로지를 설정해 보겠습니다.

• 복제본 app-1 역할을 하게 될 것이다 api역할을 포함하는 vshard-router. 여기에는 인스턴스가 하나만 있습니다.
• 복제세트 storage-1 역할을 구현한다 storage (그리고 동시에 vshard-storage), 여기서는 서로 다른 머신의 두 인스턴스를 추가합니다.

예제를 실행하려면 다음이 필요합니다. 방랑자 и 책임감있는 (버전 2.8 이상).

역할 자체는 앤서블 갤럭시. 이는 작업을 공유하고 기성 역할을 사용할 수 있는 저장소입니다.

다음 예시를 사용하여 저장소를 복제하세요.

$ git clone https://github.com/dokshina/deploy-tarantool-cartridge-app.git
$ cd deploy-tarantool-cartridge-app && git checkout 1.0.0

우리는 가상 머신을 키웁니다:

$ vagrant up

Tarantool Cartridge ansible 역할을 설치합니다.

$ ansible-galaxy install tarantool.cartridge,1.0.1

설치된 역할을 실행합니다.

$ ansible-playbook -i hosts.yml playbook.yml

플레이북 실행이 끝나기를 기다리고 있습니다. http://localhost:8181/admin/cluster/dashboard 결과를 즐기십시오.

데이터를 쏟아부을 수 있습니다. 멋지죠?

이제 이 작업을 수행하는 방법을 알아보고 동시에 토폴로지에 다른 복제본 세트를 추가해 보겠습니다.

우리는 이해하기 시작합니다

그래서 무슨 일이 일어났나요?

우리는 두 개의 VM을 준비하고 클러스터를 설정하는 Ansible 플레이북을 실행했습니다. 파일 내용을 살펴보자 playbook.yml:

---
- name: Deploy my Tarantool Cartridge app
  hosts: all
  become: true
  become_user: root
  tasks:
  - name: Import Tarantool Cartridge role
    import_role:
      name: tarantool.cartridge

여기서는 흥미로운 일이 일어나지 않습니다. 우리는 ansible-role을 시작합니다. tarantool.cartridge.

가장 중요한 모든 것(즉, 클러스터 구성)은 다음 위치에 있습니다. 목록-파일 hosts.yml:

---
all:
  vars:
    # common cluster variables
    cartridge_app_name: getting-started-app
    cartridge_package_path: ./getting-started-app-1.0.0-0.rpm  # path to package

    cartridge_cluster_cookie: app-default-cookie  # cluster cookie

    # common ssh options
    ansible_ssh_private_key_file: ~/.vagrant.d/insecure_private_key
    ansible_ssh_common_args: '-o IdentitiesOnly=yes -o UserKnownHostsFile=/dev/null -o StrictHostKeyChecking=no'

  # INSTANCES
  hosts:
    storage-1:
      config:
        advertise_uri: '172.19.0.2:3301'
        http_port: 8181

    app-1:
      config:
        advertise_uri: '172.19.0.3:3301'
        http_port: 8182

    storage-1-replica:
      config:
        advertise_uri: '172.19.0.3:3302'
        http_port: 8183

  children:
    # GROUP INSTANCES BY MACHINES
    host1:
      vars:
        # first machine connection options
        ansible_host: 172.19.0.2
        ansible_user: vagrant

      hosts:  # instances to be started on the first machine
        storage-1:

    host2:
      vars:
        # second machine connection options
        ansible_host: 172.19.0.3
        ansible_user: vagrant

      hosts:  # instances to be started on the second machine
        app-1:
        storage-1-replica:

    # GROUP INSTANCES BY REPLICA SETS
    replicaset_app_1:
      vars:  # replica set configuration
        replicaset_alias: app-1
        failover_priority:
          - app-1  # leader
        roles:
          - 'api'

      hosts:  # replica set instances
        app-1:

    replicaset_storage_1:
      vars:  # replica set configuration
        replicaset_alias: storage-1
        weight: 3
        failover_priority:
          - storage-1  # leader
          - storage-1-replica
        roles:
          - 'storage'

      hosts:   # replica set instances
        storage-1:
        storage-1-replica:

우리에게 필요한 것은 이 파일의 내용을 변경하여 인스턴스와 복제본 세트를 관리하는 방법을 배우는 것뿐입니다. 다음으로 새로운 섹션을 추가하겠습니다. 어디에 추가해야 할지 혼동하지 않으려면 이 파일의 최종 버전을 살펴보세요. hosts.updated.yml, 이는 예제 저장소에 있습니다.

인스턴스 관리

Ansible의 관점에서 각 인스턴스는 호스트입니다(철 서버와 혼동하지 마십시오). Ansible이 관리할 인프라 노드입니다. 각 호스트에 대해 연결 매개변수(예: ansible_host и ansible_user) 및 인스턴스 구성도 마찬가지입니다. 인스턴스에 대한 설명은 섹션에 있습니다. hosts.

인스턴스 구성을 고려하십시오. storage-1:

all:
  vars:
    ...

  # INSTANCES
  hosts:
    storage-1:
      config:
        advertise_uri: '172.19.0.2:3301'
        http_port: 8181

  ...

변수에서 config 인스턴스 매개변수를 지정했습니다. advertise URI и HTTP port.
다음은 인스턴스 매개변수입니다. app-1 и storage-1-replica.

각 인스턴스에 대한 연결 매개변수를 Ansible에 알려주어야 합니다. 인스턴스를 가상 머신 그룹으로 그룹화하는 것이 논리적인 것 같습니다. 이를 위해 인스턴스가 그룹으로 결합됩니다. host1 и host2및 섹션의 각 그룹에서 vars 가치 ansible_host и ansible_user 하나의 가상 머신에 대해. 그리고 섹션에서는 hosts - 이 그룹에 포함된 호스트(인스턴스):

all:
  vars:
    ...
  hosts:
    ...
  children:
    # GROUP INSTANCES BY MACHINES
    host1:
      vars:
        # first machine connection options
        ansible_host: 172.19.0.2
        ansible_user: vagrant
       hosts:  # instances to be started on the first machine
        storage-1:

     host2:
      vars:
        # second machine connection options
        ansible_host: 172.19.0.3
        ansible_user: vagrant
       hosts:  # instances to be started on the second machine
        app-1:
        storage-1-replica:

우리는 변하기 시작한다 hosts.yml. 두 개의 인스턴스를 더 추가해 보겠습니다. storage-2-replica 첫 번째 가상 머신에서 storage-2 두 번째:

all:
  vars:
    ...

  # INSTANCES
  hosts:
    ...
    storage-2:  # <==
      config:
        advertise_uri: '172.19.0.3:3303'
        http_port: 8184

    storage-2-replica:  # <==
      config:
        advertise_uri: '172.19.0.2:3302'
        http_port: 8185

  children:
    # GROUP INSTANCES BY MACHINES
    host1:
      vars:
        ...
      hosts:  # instances to be started on the first machine
        storage-1:
        storage-2-replica:  # <==

    host2:
      vars:
        ...
      hosts:  # instances to be started on the second machine
        app-1:
        storage-1-replica:
        storage-2:  # <==
  ...

Ansible 플레이북을 실행합니다.

$ ansible-playbook -i hosts.yml 
                   --limit storage-2,storage-2-replica 
                   playbook.yml

옵션에 주목하세요 --limit. 각 클러스터 인스턴스는 Ansible 용어로 호스트이므로 플레이북을 실행할 때 구성해야 하는 인스턴스를 명시적으로 지정할 수 있습니다.

웹 UI로 돌아가기 http://localhost:8181/admin/cluster/dashboard 새로운 인스턴스를 관찰하세요.

우리는 성공에 안주하지 않고 토폴로지 제어를 마스터할 것입니다.

토폴로지 관리

새 인스턴스를 복제본 세트로 병합해 보겠습니다. storage-2. 새 그룹을 추가해 보겠습니다. replicaset_storage_2 변수에서 복제본 세트의 매개변수를 다음과 유사하게 설명합니다. replicaset_storage_1. 섹션에서 hosts 이 그룹(즉, 복제본 세트)에 포함될 인스턴스를 지정합니다.

---
all:
  vars:
    ...
  hosts:
    ...
  children:
    ...
    # GROUP INSTANCES BY REPLICA SETS
    ...
    replicaset_storage_2:  # <==
      vars:  # replicaset configuration
        replicaset_alias: storage-2
        weight: 2
        failover_priority:
          - storage-2
          - storage-2-replica
        roles:
          - 'storage'

      hosts:   # replicaset instances
        storage-2:
        storage-2-replica:

플레이북을 다시 시작해 보겠습니다.

$ ansible-playbook -i hosts.yml 
                   --limit replicaset_storage_2 
                   --tags cartridge-replicasets 
                   playbook.yml

옵션별 --limit 이번에는 복제 세트에 해당하는 그룹의 이름을 전달했습니다.

옵션을 고려하십시오 tags.

우리의 역할은 다음 태그로 표시된 다양한 작업을 순차적으로 수행합니다.

• cartridge-instances: 인스턴스 관리(구성, 회원가입);
• cartridge-replicasets: 토폴로지 관리(복제본 관리 및 클러스터에서 인스턴스 영구 제거(추방))
• cartridge-config: 기타 클러스터 매개변수(vshard 부트스트래핑, 자동 장애 조치 모드, 인증 매개변수 및 애플리케이션 구성)를 관리합니다.

수행하려는 작업 부분을 명시적으로 지정할 수 있으며, 그러면 해당 역할은 나머지 작업을 건너뜁니다. 우리의 경우에는 토폴로지로만 작업하기를 원하므로 다음과 같이 지정했습니다. cartridge-replicasets.

우리의 노력의 결과를 평가해 봅시다. 새로운 복제 세트 찾기 http://localhost:8181/admin/cluster/dashboard.

만세!

인스턴스와 복제본 세트를 재구성하여 실험하고 클러스터 토폴로지가 어떻게 변경되는지 확인하세요. 예를 들어, 다양한 운영 시나리오를 시도해 볼 수 있습니다. 롤링 업데이트 또는 증가 memtx_memory. 해당 역할은 애플리케이션의 가동 중지 시간을 줄이기 위해 인스턴스를 다시 시작하지 않고 이 작업을 수행하려고 합니다.

달리는 것을 잊지 마세요 vagrant halt작업이 끝나면 VM을 중지합니다.

후드 아래에는 무엇이 있습니까?

여기서는 실험 중 ansible 역할 내부에서 발생한 일에 대해 자세히 설명하겠습니다.

카트리지 애플리케이션 배포를 단계별로 살펴보겠습니다.

패키지 설치 및 인스턴스 시작

먼저 패키지를 서버에 전달하고 설치해야 합니다. 이제 해당 역할은 RPM 및 DEB 패키지와 함께 작동할 수 있습니다.

다음으로 인스턴스를 시작합니다. 여기에서는 모든 것이 매우 간단합니다. 각 인스턴스는 별도입니다. systemd-서비스. 나는 예에 대해 이야기하고 있습니다.

$ systemctl start myapp@storage-1

이 명령은 인스턴스를 시작합니다 storage-1 애플 리케이션 myapp. 시작된 인스턴스는 해당 인스턴스를 찾습니다. 구성 в /etc/tarantool/conf.d/. 인스턴스 로그는 다음을 사용하여 볼 수 있습니다. journald.

유닛 파일 /etc/systemd/system/[email protected] 시스템 서비스의 경우 패키지와 함께 제공됩니다.

Ansible에는 패키지 설치 및 시스템 서비스 관리를 위한 내장 모듈이 있지만 여기서는 새로운 것을 발명하지 않았습니다.

클러스터 토폴로지 구성

그리고 여기서 가장 흥미로운 일이 시작됩니다. 동의합니다. 패키지를 설치하고 실행하기 위해 특별한 ansible 역할을 사용하는 것은 이상할 것입니다. systemd-서비스.

클러스터를 수동으로 설정할 수 있습니다.

• 첫 번째 옵션: 웹 UI를 열고 버튼을 클릭합니다. 여러 인스턴스를 한 번 시작하는 경우 매우 적합합니다.
• 두 번째 옵션: GraphQl API를 사용할 수 있습니다. 여기에서는 Python으로 스크립트 작성과 같은 작업을 이미 자동화할 수 있습니다.
• 세 번째 옵션(정신이 강한 경우): 서버로 이동하여 다음을 사용하여 인스턴스 중 하나에 연결합니다. tarantoolctl connect Lua 모듈을 사용하여 필요한 모든 조작을 수행합니다. cartridge.

우리 발명품의 주요 임무는 귀하에게 가장 어려운 작업인 이 작업을 수행하는 것입니다.

Ansible을 사용하면 자신만의 모듈을 작성하고 이를 역할에서 사용할 수 있습니다. 우리 역할은 이러한 모듈을 사용하여 클러스터의 다양한 구성 요소를 관리합니다.

어떻게 작동하나요? 선언적 구성에서 원하는 클러스터 상태를 설명하고 역할은 각 모듈에 구성 섹션을 입력으로 제공합니다. 모듈은 클러스터의 현재 상태를 수신하고 이를 입력과 비교합니다. 또한 인스턴스 중 하나의 소켓을 통해 코드가 실행되어 클러스터를 원하는 상태로 만듭니다.

결과

오늘 우리는 Tarantool Cartridge에 애플리케이션을 배포하고 간단한 토폴로지를 설정하는 방법을 설명하고 보여주었습니다. 이를 위해 우리는 사용하기 쉽고 많은 인프라 노드(우리의 경우 클러스터 인스턴스)를 동시에 구성할 수 있는 강력한 도구인 Ansible을 사용했습니다.

위에서는 Ansible을 사용하여 클러스터 구성을 설명하는 여러 방법 중 하나를 다루었습니다. 다음 단계로 나아갈 준비가 되었음을 확인한 후에는 다음 단계를 따르세요. 모범 사례 플레이북 작성을 위해. 다음을 사용하여 토폴로지를 관리하는 것이 더 편리할 수 있습니다. group_vars и host_vars.

곧 토폴로지에서 인스턴스를 영구적으로 제거(추출)하고, vshard를 부트스트랩하고, 자동 장애 조치 모드를 관리하고, 인증을 구성하고, 클러스터 구성을 패치하는 방법을 알려드리겠습니다. 그동안 혼자 공부할 수 있어요 문서 클러스터 매개변수를 변경하여 실험해 보세요.

뭔가 안되면 꼭 해보세요 알리다 문제에 대해 우리에게. 빠르게 분해해드리겠습니다!

출처 : habr.com