হ্যালো সবাই!

আমি একটি হোটেল বুকিং পরিষেবায় একজন DevOps প্রকৌশলী হিসাবে কাজ করি। Ostrovok.ru. এই নিবন্ধে, আমি উত্তরযোগ্য ভূমিকা পরীক্ষা করার আমাদের অভিজ্ঞতা সম্পর্কে কথা বলতে চাই।

Ostrovok.ru-এ, আমরা কনফিগারেশন ম্যানেজার হিসেবে এনসিবল ব্যবহার করি। সম্প্রতি, আমরা ভূমিকাগুলি পরীক্ষা করার প্রয়োজনে এসেছি, তবে এটি দেখা গেছে, এর জন্য এতগুলি সরঞ্জাম নেই - সবচেয়ে জনপ্রিয়, সম্ভবত, অণু কাঠামো, তাই আমরা এটি ব্যবহার করার সিদ্ধান্ত নিয়েছি। কিন্তু দেখা গেল যে তার ডকুমেন্টেশন অনেক ত্রুটি সম্পর্কে নীরব। আমরা রাশিয়ান ভাষায় একটি পর্যাপ্ত বিশদ ম্যানুয়াল খুঁজে পাইনি, তাই আমরা এই নিবন্ধটি লেখার সিদ্ধান্ত নিয়েছি।

অণু

অণু - উত্তরযোগ্য ভূমিকা পরীক্ষা করতে সাহায্য করার জন্য একটি কাঠামো।

সরলীকৃত বর্ণনা: অণু আপনার নির্দিষ্ট করা প্ল্যাটফর্মে একটি উদাহরণ তৈরি করে (ক্লাউড, ভার্চুয়াল মেশিন, ধারক; আরও বিশদ বিবরণের জন্য, বিভাগটি দেখুন চালক), এটিতে আপনার ভূমিকা চালায়, তারপর পরীক্ষা চালায় এবং উদাহরণটি মুছে দেয়। একটি ধাপে ব্যর্থতার ক্ষেত্রে, অণু আপনাকে এটি সম্পর্কে অবহিত করবে।

এখন আরো.

তত্ত্ব একটি বিট

অণুর দুটি মূল সত্তা বিবেচনা করুন: দৃশ্যকল্প এবং ড্রাইভার।

দৃশ্যপট

স্ক্রিপ্টে কী, কোথায়, কীভাবে এবং কী ক্রমানুসারে সঞ্চালিত হবে তার বর্ণনা রয়েছে। একটি ভূমিকার বেশ কয়েকটি স্ক্রিপ্ট থাকতে পারে এবং প্রতিটি পথ বরাবর একটি ডিরেক্টরি <role>/molecule/<scenario>, যা পরীক্ষার জন্য প্রয়োজনীয় ক্রিয়াগুলির বর্ণনা রয়েছে৷ স্ক্রিপ্ট অন্তর্ভুক্ত করা আবশ্যক default, যা আপনি একটি অণু দিয়ে ভূমিকা শুরু করলে স্বয়ংক্রিয়ভাবে তৈরি হবে। নিম্নলিখিত স্ক্রিপ্টগুলির নাম আপনার উপর নির্ভর করে।

একটি স্ক্রিপ্টে পরীক্ষার ক্রিয়াগুলির ক্রম বলা হয় জরায়ু, এবং ডিফল্টরূপে এটি হল:

(পদক্ষেপ লেবেল করা হয়েছে ?, ব্যবহারকারী দ্বারা নির্দিষ্ট না হলে ডিফল্টরূপে বাদ দেওয়া হয়)

• lint - চলমান লিন্টার। ডিফল্টরূপে ব্যবহার করা হয় yamllint и flake8,
• destroy - অণুর শেষ লঞ্চ থেকে দৃষ্টান্ত মুছে ফেলা (যদি থাকে),
• dependency? - পরীক্ষিত ভূমিকার উত্তরযোগ্য নির্ভরতার ইনস্টলেশন,
• syntax - ব্যবহার করে ভূমিকার সিনট্যাক্স পরীক্ষা করা হচ্ছে ansible-playbook --syntax-check,
• create - একটি উদাহরণ তৈরি করা,
• prepare? - উদাহরণের প্রস্তুতি; যেমন python2 চেক/ইনস্টল করুন
• converge - প্লেবুক লঞ্চ করা হচ্ছে পরীক্ষা করা হচ্ছে,
• idempotence - অদম্যতা পরীক্ষার জন্য প্লেবুক পুনরায় চালু করা,
• side_effect? - ক্রিয়াগুলি সরাসরি ভূমিকার সাথে সম্পর্কিত নয়, তবে পরীক্ষার জন্য প্রয়োজনীয়,
• verify - ব্যবহার করে ফলাফল কনফিগারেশনের পরীক্ষা চলছে testinfra(ডিফল্ট) /goss/inspec,
• cleanup? - (নতুন সংস্করণে) - মোটামুটিভাবে বলতে গেলে, অণু দ্বারা প্রভাবিত বাহ্যিক অবকাঠামো "পরিষ্কার করা",
• destroy - একটি উদাহরণ মুছে ফেলা হচ্ছে

এই ক্রমটি বেশিরভাগ ক্ষেত্রেই কভার করে, তবে প্রয়োজনে পরিবর্তন করা যেতে পারে।

উপরের প্রতিটি ধাপের সাথে আলাদাভাবে চালানো যেতে পারে molecule <command>. তবে এটি বোঝা উচিত যে এই জাতীয় প্রতিটি ক্লি-কমান্ডের জন্য নিজস্ব ক্রিয়াগুলির ক্রম থাকতে পারে, যা আপনি কার্যকর করার মাধ্যমে খুঁজে পেতে পারেন molecule matrix <command>. উদাহরণস্বরূপ, কমান্ড চালানোর সময় converge (পরীক্ষার অধীনে প্লেবুক চালানো), নিম্নলিখিত ক্রিয়াগুলি সঞ্চালিত হবে:

$ molecule matrix converge
...
└── default         # название сценария
    ├── dependency  # установка зависимостей
    ├── create      # создание инстанса
    ├── prepare     # преднастройка инстанса
    └── converge    # прогон плейбука

এই কর্মের ক্রম সম্পাদনা করা যেতে পারে. তালিকা থেকে কিছু যদি ইতিমধ্যেই করা হয়ে থাকে, তাহলে তা বাদ দেওয়া হবে। বর্তমান অবস্থা, সেইসাথে দৃষ্টান্তের কনফিগারেশন, অণু ডিরেক্টরিতে সঞ্চয় করে $TMPDIR/molecule/<role>/<scenario>.

সঙ্গে ধাপ যোগ করুন ? আপনি উত্তরযোগ্য-প্লেবুক বিন্যাসে পছন্দসই ক্রিয়াগুলি বর্ণনা করতে পারেন এবং ধাপ অনুসারে ফাইলের নাম তৈরি করতে পারেন: prepare.yml/side_effect.yml. এই ফাইলগুলি আশা করুন অণুটি স্ক্রিপ্ট ফোল্ডারে থাকবে।

চালক

ড্রাইভার হল একটি সত্তা যেখানে পরীক্ষার উদাহরণ তৈরি করা হয়।
স্ট্যান্ডার্ড ড্রাইভারের তালিকা যার জন্য মলিকিউলের টেমপ্লেট প্রস্তুত রয়েছে: Azure, Docker, EC2, GCE, LXC, LXD, OpenStack, Vagrant, Delegated।

বেশিরভাগ ক্ষেত্রে, টেমপ্লেটগুলি ফাইল create.yml и destroy.yml স্ক্রিপ্ট ফোল্ডারে যা যথাক্রমে একটি উদাহরণ তৈরি এবং মুছে ফেলার বর্ণনা দেয়।
ব্যতিক্রমগুলি হল ডকার এবং ভ্যাগ্রান্ট, কারণ তাদের মডিউলগুলির সাথে মিথস্ক্রিয়া পূর্বোক্ত ফাইলগুলি ছাড়াই ঘটতে পারে।

এটি ডেলিগেটেড ড্রাইভার হাইলাইট করা মূল্যবান, যেহেতু এটি একটি দৃষ্টান্ত তৈরি এবং মুছে ফেলার জন্য ফাইলগুলিতে ব্যবহার করা হয়, শুধুমাত্র দৃষ্টান্তগুলির কনফিগারেশনের সাথে কাজটি বর্ণনা করা হয়, বাকিটি ইঞ্জিনিয়ার দ্বারা বর্ণনা করা উচিত।

ডিফল্ট ড্রাইভার হল ডকার।

এখন অনুশীলনে এগিয়ে যাওয়া যাক এবং সেখানে আরও বৈশিষ্ট্য বিবেচনা করা যাক।

গেটিং স্টার্টেড

একটি "হ্যালো ওয়ার্ল্ড" হিসাবে, আসুন একটি সাধারণ nginx ইনস্টলেশন ভূমিকা পরীক্ষা করি। আমরা ড্রাইভার হিসাবে ডকারকে বেছে নেব - আমি মনে করি আপনার বেশিরভাগই এটি ইনস্টল করেছেন (এবং মনে রাখবেন যে ডকার হল ডিফল্ট ড্রাইভার)।

প্রস্তুত করা virtualenv এবং এটিতে ইনস্টল করুন molecule:

> pip install virtualenv
> virtualenv -p `which python2` venv
> source venv/bin/activate
> pip install molecule docker  # molecule установит ansible как зависимость; docker для драйвера

পরবর্তী পদক্ষেপটি নতুন ভূমিকা শুরু করা।
একটি নতুন ভূমিকার সূচনা, সেইসাথে একটি নতুন স্ক্রিপ্ট, কমান্ড ব্যবহার করে সঞ্চালিত হয় molecule init <params>:

> molecule init role -r nginx
--> Initializing new role nginx...
Initialized role in <path>/nginx successfully.
> cd nginx
> tree -L 1
.
├── README.md
├── defaults
├── handlers
├── meta
├── molecule
├── tasks
└── vars

6 directories, 1 file

এটি একটি সাধারণ জবাবদিহিমূলক ভূমিকায় পরিণত হয়েছে। আরও, CLI অণুর সাথে সমস্ত মিথস্ক্রিয়া ভূমিকার মূল থেকে তৈরি করা হয়।

চলুন দেখি ভূমিকা ডিরেক্টরিতে কি আছে:

> tree molecule/default/
molecule/default/
├── Dockerfile.j2  # Jinja-шаблон для Dockerfile
├── INSTALL.rst.   # Немного информации об установке зависимостей сценария
├── molecule.yml   # Файл конфигурации
├── playbook.yml   # Плейбук запуска роли
└── tests          # Директория с тестами стадии verify
    └── test_default.py

1 directory, 6 files

এর কনফিগারেশন বিশ্লেষণ করা যাক molecule/default/molecule.yml (শুধু ডকার ইমেজ প্রতিস্থাপন):

---
dependency:
  name: galaxy
driver:
  name: docker
lint:
  name: yamllint
platforms:
  - name: instance
    image: centos:7
provisioner:
  name: ansible
  lint:
    name: ansible-lint
scenario:
  name: default
verifier:
  name: testinfra
  lint:
    name: flake8

বশ্যতা

এই বিভাগটি নির্ভরশীলতার উত্স বর্ণনা করে।

সম্ভাব্য বিকল্পসমূহ: ছায়াপথ, গিল্ট, শেল।

শেল শুধুমাত্র একটি কমান্ড শেল যা গ্যালাক্সি এবং গিল্ট আপনার প্রয়োজনগুলিকে কভার না করার ক্ষেত্রে ব্যবহার করা হয়।

আমি এখানে দীর্ঘকাল থাকব না, এটি যথেষ্ট বর্ণনা করা হয়েছে ডকুমেন্টেশন.

চালক

ড্রাইভারের নাম। আমাদের ডকার হয়.

তিসি

লিন্টার হল ইয়ামলিন্ট।

কনফিগারেশনের এই অংশে দরকারী বিকল্পগুলি হল yamllint, ফরোয়ার্ড এনভায়রনমেন্ট ভেরিয়েবল বা লিন্টার নিষ্ক্রিয় করার জন্য একটি কনফিগারেশন ফাইল নির্দিষ্ট করার ক্ষমতা:

lint:
  name: yamllint
  options:
    config-file: foo/bar
  env:
    FOO: bar
  enabled: False

প্ল্যাটফর্মের

দৃষ্টান্তগুলির কনফিগারেশন বর্ণনা করে।
ড্রাইভার হিসাবে ডকারের ক্ষেত্রে, অণুটি এই বিভাগে পুনরাবৃত্তি করা হয় এবং তালিকার প্রতিটি উপাদান পাওয়া যায় Dockerfile.j2 একটি পরিবর্তনশীল হিসাবে item.

চালকের ক্ষেত্রে যেটা প্রয়োজন create.yml и destroy.yml, বিভাগ তাদের হিসাবে উপলব্ধ molecule_yml.platforms, এবং এটির পুনরাবৃত্তিগুলি ইতিমধ্যেই এই ফাইলগুলিতে বর্ণনা করা হয়েছে।

যেহেতু অণু উত্তরযোগ্য মডিউলগুলিতে দৃষ্টান্তগুলির নিয়ন্ত্রণ সরবরাহ করে, তাই সম্ভাব্য সেটিংসের তালিকাটিও সেখানে সন্ধান করা উচিত। ডকারের জন্য, উদাহরণস্বরূপ, মডিউল ব্যবহার করা হয় docker_container_module. অন্যান্য ড্রাইভারে কোন মডিউল ব্যবহার করা হয় তা পাওয়া যাবে ডকুমেন্টেশন.

পাশাপাশি বিভিন্ন চালক ব্যবহারের উদাহরণও পাওয়া যাবে অণু নিজেই পরীক্ষা.

এখানে প্রতিস্থাপন করুন সেন্টোস:7 উপর উবুন্টু.

বিধানকারী

"সরবরাহকারী" - একটি সত্তা যা দৃষ্টান্ত পরিচালনা করে। অণুর ক্ষেত্রে, এটি উত্তরযোগ্য, অন্যদের জন্য সমর্থন পরিকল্পিত নয়, তাই এই বিভাগটিকে সতর্কতার সাথে উত্তরযোগ্য বর্ধিত কনফিগারেশন বলা যেতে পারে।
এখানে আপনি অনেক কিছু নির্দিষ্ট করতে পারেন, আমি আমার মতে প্রধান পয়েন্টগুলি হাইলাইট করব:

• প্লেবুক: আপনি নির্দিষ্ট পর্যায়ে কোন প্লেবুক ব্যবহার করা উচিত তা নির্দিষ্ট করতে পারেন।

provisioner:
  name: ansible
  playbooks:
    create: create.yml
    destroy: ../default/destroy.yml
    converge: playbook.yml
    side_effect: side_effect.yml
    cleanup: cleanup.yml

• config_options: উত্তরযোগ্য কনফিগারেশন

provisioner:
  name: ansible
  config_options:
    defaults:
      fact_caching: jsonfile
    ssh_connection:
      scp_if_ssh: True

• সংযোগ_বিকল্প: বিকল্প সংযোগ

provisioner:
  name: ansible  
  connection_options:
    ansible_ssh_common_args: "-o 'UserKnownHostsFile=/dev/null' -o 'ForwardAgent=yes'"

• অপশন: উত্তরযোগ্য বিকল্প এবং পরিবেশ ভেরিয়েবল

provisioner:
  name: ansible  
  options:
    vvv: true
    diff: true
  env:
    FOO: BAR

দৃশ্যকল্প

স্ক্রিপ্ট সিকোয়েন্সের নাম এবং বর্ণনা।
আপনি কী যোগ করে যেকোনো কমান্ডের ডিফল্ট অ্যাকশন ম্যাট্রিক্স পরিবর্তন করতে পারেন <command>_sequence এবং এটির জন্য একটি মান হিসাবে আমাদের প্রয়োজনীয় পদক্ষেপগুলির তালিকা নির্ধারণ করে।
ধরা যাক প্লেবুক রান কমান্ড চালানোর সময় আমরা কর্মের ক্রম পরিবর্তন করতে চাই: molecule converge

# изначально:
# - dependency
# - create
# - prepare
# - converge
scenario:
  name: default
  converge_sequence:
    - create
    - converge

চেক

পরীক্ষার জন্য একটি কাঠামো এবং এটির জন্য একটি লিন্টার সেট আপ করা। ডিফল্ট লিন্টার হয় testinfra и flake8. সম্ভাব্য বিকল্প উপরের মত একই:

verifier:
  name: testinfra
  additional_files_or_dirs:
    - ../path/to/test_1.py
    - ../path/to/test_2.py
    - ../path/to/directory/*
  options:
    n: 1
  enabled: False
  env:
    FOO: bar
  lint:
    name: flake8
    options:
      benchmark: True
    enabled: False
    env:
      FOO: bar

আমাদের ভূমিকায় ফিরে আসা যাক। ফাইল সম্পাদনা করা যাক tasks/main.yml এই ধরনের:

---
- name: Install nginx
  apt:
    name: nginx
    state: present

- name: Start nginx
  service:
    name: nginx
    state: started

এবং পরীক্ষা যোগ করুন molecule/default/tests/test_default.py

def test_nginx_is_installed(host):
    nginx = host.package("nginx")
    assert nginx.is_installed

def test_nginx_running_and_enabled(host):
    nginx = host.service("nginx")
    assert nginx.is_running
    assert nginx.is_enabled

def test_nginx_config(host):
    host.run("nginx -t")

সম্পন্ন হয়েছে, এটি শুধুমাত্র চালানোর জন্য অবশিষ্ট রয়েছে (ভূমিকাটির মূল থেকে, আমি আপনাকে মনে করিয়ে দিই):

> molecule test

স্পয়লারের নিচে দীর্ঘ নিষ্কাশন:

--> Validating schema <path>/nginx/molecule/default/molecule.yml.
Validation completed successfully.
--> Test matrix

└── default
    ├── lint
    ├── destroy
    ├── dependency
    ├── syntax
    ├── create
    ├── prepare
    ├── converge
    ├── idempotence
    ├── side_effect
    ├── verify
    └── destroy

--> Scenario: 'default'
--> Action: 'lint'
--> Executing Yamllint on files found in <path>/nginx/...
Lint completed successfully.
--> Executing Flake8 on files found in <path>/nginx/molecule/default/tests/...
Lint completed successfully.
--> Executing Ansible Lint on <path>/nginx/molecule/default/playbook.yml...
Lint completed successfully.
--> Scenario: 'default'
--> Action: 'destroy'

    PLAY [Destroy] *****************************************************************

    TASK [Destroy molecule instance(s)] ********************************************
    changed: [localhost] => (item=None)
    changed: [localhost]

    TASK [Wait for instance(s) deletion to complete] *******************************
    ok: [localhost] => (item=None)
    ok: [localhost]

    TASK [Delete docker network(s)] ************************************************

    PLAY RECAP *********************************************************************
    localhost                  : ok=2    changed=1    unreachable=0    failed=0

--> Scenario: 'default'
--> Action: 'dependency'
Skipping, missing the requirements file.
--> Scenario: 'default'
--> Action: 'syntax'

    playbook: <path>/nginx/molecule/default/playbook.yml

--> Scenario: 'default'
--> Action: 'create'

    PLAY [Create] ******************************************************************

    TASK [Log into a Docker registry] **********************************************
    skipping: [localhost] => (item=None)

    TASK [Create Dockerfiles from image names] *************************************
    changed: [localhost] => (item=None)
    changed: [localhost]

    TASK [Discover local Docker images] ********************************************
    ok: [localhost] => (item=None)
    ok: [localhost]

    TASK [Build an Ansible compatible image] ***************************************
    changed: [localhost] => (item=None)
    changed: [localhost]

    TASK [Create docker network(s)] ************************************************

    TASK [Create molecule instance(s)] *********************************************
    changed: [localhost] => (item=None)
    changed: [localhost]

    TASK [Wait for instance(s) creation to complete] *******************************
    changed: [localhost] => (item=None)
    changed: [localhost]

    PLAY RECAP *********************************************************************
    localhost                  : ok=5    changed=4    unreachable=0    failed=0

--> Scenario: 'default'
--> Action: 'prepare'
Skipping, prepare playbook not configured.
--> Scenario: 'default'
--> Action: 'converge'

    PLAY [Converge] ****************************************************************

    TASK [Gathering Facts] *********************************************************
    ok: [instance]

    TASK [nginx : Install nginx] ***************************************************
    changed: [instance]

    TASK [nginx : Start nginx] *****************************************************
    changed: [instance]

    PLAY RECAP *********************************************************************
    instance                   : ok=3    changed=2    unreachable=0    failed=0

--> Scenario: 'default'
--> Action: 'idempotence'
Idempotence completed successfully.
--> Scenario: 'default'
--> Action: 'side_effect'
Skipping, side effect playbook not configured.
--> Scenario: 'default'
--> Action: 'verify'
--> Executing Testinfra tests found in <path>/nginx/molecule/default/tests/...
    ============================= test session starts ==============================
    platform darwin -- Python 2.7.15, pytest-4.3.0, py-1.8.0, pluggy-0.9.0
    rootdir: <path>/nginx/molecule/default, inifile:
    plugins: testinfra-1.16.0
collected 4 items

    tests/test_default.py ....                                               [100%]

    ========================== 4 passed in 27.23 seconds ===========================
Verifier completed successfully.
--> Scenario: 'default'
--> Action: 'destroy'

    PLAY [Destroy] *****************************************************************

    TASK [Destroy molecule instance(s)] ********************************************
    changed: [localhost] => (item=None)
    changed: [localhost]

    TASK [Wait for instance(s) deletion to complete] *******************************
    changed: [localhost] => (item=None)
    changed: [localhost]

    TASK [Delete docker network(s)] ************************************************

    PLAY RECAP *********************************************************************
    localhost                  : ok=2    changed=2    unreachable=0    failed=0

আমাদের সাধারণ ভূমিকা সমস্যা ছাড়াই পরীক্ষা করা হয়েছিল।
এটা মনে রাখা মূল্যবান যে যদি কাজের সময় সমস্যা হয় molecule test, তারপর আপনি যদি ডিফল্ট ক্রম পরিবর্তন না করেন, তাহলে অণু উদাহরণটি মুছে ফেলবে।

নিম্নলিখিত কমান্ডগুলি ডিবাগ করার জন্য দরকারী:

> molecule --debug <command> # debug info. При обычном запуске Молекула скрывает логи.
> molecule converge          # Оставляет инстанс после прогона тестируемой роли.
> molecule login             # Зайти в созданный инстанс.
> molecule --help            # Полный список команд.

বিদ্যমান ভূমিকা

একটি বিদ্যমান ভূমিকা একটি নতুন স্ক্রিপ্ট যোগ করা হয় ভূমিকা ডিরেক্টরি থেকে নিম্নলিখিত কমান্ড সহ:

# полный список доступных параметров
> molecule init scenarion --help
# создание нового сценария
> molecule init scenario -r <role_name> -s <scenario_name>

যদি এটি ভূমিকার প্রথম দৃশ্য, তারপর পরামিতি -s বাদ দেওয়া যেতে পারে কারণ এটি একটি স্ক্রিপ্ট তৈরি করবে default.

উপসংহার

আপনি দেখতে পাচ্ছেন, অণুটি খুব জটিল নয়, এবং আপনার নিজস্ব টেমপ্লেট ব্যবহার করে, একটি নতুন স্ক্রিপ্ট স্থাপন করে উদাহরণ তৈরি এবং প্লেবুকগুলি মুছে ফেলার ভেরিয়েবলগুলি সম্পাদনা করার জন্য হ্রাস করা যেতে পারে। অণুটি সিআই সিস্টেমের সাথে নির্বিঘ্নে সংহত করে, যা আপনাকে প্লেবুকগুলির ম্যানুয়াল পরীক্ষার জন্য সময় কমিয়ে বিকাশের গতি বাড়াতে দেয়।

আপনার মনোযোগের জন্য আপনাকে ধন্যবাদ। আপনার যদি উত্তরযোগ্য ভূমিকাগুলি পরীক্ষা করার অভিজ্ঞতা থাকে এবং এটি অণুর সাথে সম্পর্কিত না হয় তবে মন্তব্যে এটি সম্পর্কে আমাদের বলুন!

উত্স: www.habr.com