Archi что это за программа

КУРС ОТ ARCHI.ENGLISH — SPEAK IT | ОБЗОР

Источник: referat.co

Автоматизируем работу с ArchiMate в CI пайплайнах

В этой статье я дам краткую вводную, что такое Archi и ArchiMate. Расскажу о коллективной работе с Archi используя расширение coArchi, после чего предоставлю контейнер позволяющий автоматизировать работу по созданию HTML и PDF документов с ArchiMate моделями. Завершим же, созданием своего GitHub Action, настроим GitHub и GitLab пайплайн с последующей публикацией модели в GitHub/GitLab Pages.

В чем основная проблематика и причина появления этой автоматизации? Логично утверждать, что любая автоматика экономит время и выполняет рутину за вас, но основной причиной появления данного инструмента и статьи, является простота публикации моделей (схем). Я столкнулся с тем, что большинству нужно просто посмотреть или продемонстрировать схему, но ни кто не хочет разбираться с установкой дополнительного ПО, подключать к нему плагины, настраивать подключение к git репозиторию. Web-страница с актуальной и интерактивной моделью — это то, что нужно среднестатистическому менеджеру, да и архитектора не побеспокоят просьбой сделать скриншот текущей модели.

Для тех кому все подробности не нужны, резюмирую: используя этот GitHub Action или этот контейнер в результате получим такой результат.

Что такое Archi и ArchiMate

Набор кроссплатформенных инструментов моделирования Archi предназначен для архитекторов и разработчиков моделей всех уровней. Archi написан на Java и распространяются под лицензией MIT, репозиторий проекта доступен на GitHub. Он обеспечивает низкий порог входа для пользователей работающих с языком моделирования ArchiMate.

ArchiMate (в оригинале Architecture-Animate) — это открытый и независимый язык моделирования архитектуры предприятия и визуализации архитектуры внутри и за пределами бизнес-процессов. Это технический стандарт от The Open Group, базирующийся на IEEE 1471.

ArchiMate дистанцируется от других языков, таких как UML и BPMN по предназначению для моделирования предприятия. Цель ArchiMate — «быть настолько лаконичным, насколько это возможно» (as small as possible), а не охватить все возможные сценарии.

Основные сущности и типы связей языка ArchiMate можно рассматривать как структуру, так называемую ArchiMate Framework.

Слои языка хорошо соотносятся с соответствующими фазами метода разработки архитектуры TOGAF (TOGAF и ArchiMate являются стандартами The Open Group).

Экспорт модели

Модель ArchiMate представляет из себя XML документ и подразумевает наличие инструмента Archi для редактирования и просмотра. Archi позволяет экспортировать модель в виде отчуждаемых файлов, и поддерживает такие форматы:

• Статический HTML отчет с интерактивной структурой и навигацией;
• CSV отчет по имеющимся в модели элементам, характеристикам и связям;
• Jasper отчет в форматах PDF, HTML, RTF, PPT, ODT и DOCX;
• Экспорт модели в нативном формате XML с расширением .archimate ;
• Экспорт модели в формате Open Exchange XML.

Совместная работа

coArchi — это расширение Archi, которое позволяет вести коллективную работу над моделями ArchiMate, посредством совместного использования и управления версиями моделей в git репозитории.

Для установки расширения перейдите на страницу с списком расширений, найдите в списке coArchi и следуйте инструкциям. Репозиторий проекта на GitHub также содержит дополнительную информацию по настройке и решению проблем в работе, подробности смотрите в wiki.

ℹ️ Оригинальный файл модели ArchiMate представляет из себя единый XML документ с расширением .archimate . Для возможности совместного редактирования и слияния изменений, данная модель разбивается плагином coArchi на элементы, где каждый элемент хранится в отдельном файле. Соответственно открыть модель сохраненную в репозитории при помощи coArchi, вы сможете только используя это расширение.

Некоторые функции coArchi находятся в стадии разработки и постоянно улучшаются. На текущий момент coArchi версии 0.8.1 имеет ограниченную поддержку специализаций и образов добавленных в Archi 4.9.

ℹ️ Обратите внимание, что для работы с репозиторием по SSH средствами плагина coArchi — работают только RSA ключи в формате PEM, о чем написано в разделе вики. Также вам не удастся использовать oauth2 токен (у меня не вышло), к примеру в случае активной двухфакторной аутентификации. Судя по всему проблема связана с JGit используемым в проекте, разработчики плагина пока не дали ответа на это замечание.

Как видим, всё же имеются некоторые трудности в настройке окружения, на этапе установки coArchi и клонирования модели зачастую менеджер сдается и просто просит скриншот модели у её авторов.

Интерфейс командной строки

Помимо графического интерфейса, Archi также имеет интерфейс командной строки. Подробную справку о работе с ним вы можете найти в вики проекта.

К примеру для вывода справки с доступными аргументами выполните:

./Archi -application com.archimatetool.commandline.app -consoleLog -nosplash —help

Образ контейнера Archi

Получив сведения о том, что у Archi есть CLI, функция экспорта и возможна совместная работа в git репозитории, мы имеем все основания попытаться упаковать всё это в образ контейнера, для дальнейшего использования в пайплайне.

Поскольку некоторые библиотеки зависят от наличия драйвера дисплея, для запуска CLI в Linux, нам потребуется установить определенные библиотеки, такие как gtk3 и xvfb. В связи с этим и размер образа становиться заметно больше.

Итоговый Dockerfile доступен в репозитории:

archimate-ci-image/Dockerfile at master · WoozyMasta/archimate-ci-image

А для удобства работы со всеми аргументами командной строки и реализации возможности доступа к репозиторию модели с любыми стандартными проколами и методами аутентификации git, был реализован bash сценарий запуска entrypoint.sh:

archimate-ci-image/entrypoint.sh at master · WoozyMasta/archimate-ci-image

• В скрипте реализованы переменные окружения для управления ключевыми параметрами клонирования модели и создания отчета, что упростит применение образа в CI пайплайнах.
• Клонирование репозитория выполняется привычной утилитой git, а уже после передается Archi как модель. Так мы обходим ограничения самого coArchi.
• Выполнена обвязка для исполнения задания в GitHub Actions с созданием отдельной ветки используя git subtree и дальнейшей публикацией в GitHub Pages.
• Выполнена обвязка для более простого запуска заданий в GitLab CI

ℹ️ Git subtree выбран не спроста. Как альтернативный вариант в GitHub Pages можно опубликовать файлы из отдельного каталога текущей ветки, к примеру /docs , но в таком случае у нас в основной рабочей ветке появляются лишние автоматические «шумные» коммиты, а вместе с ними и растет размер индекса этой ветки, помимо этого, при ответвлении и слиянии правок у нас появляются конфликты в сгенерированных отчетах, которые просто так не решаются через интерфейс Archi.

Образы контейнера доступны в репозиториях:

• GHCR ghcr.io/woozymasta/archimate-ci:4.9.1-1.0
• Quay quay.io/woozymasta/archimate-ci:4.9.1-1.0
• DockerHub docker.io/woozymasta/archimate-ci:4.9.1-1.0

Пайплайн

Для демонстрации работы был создан отдельный проект на GitHub и GitLab с примером модели ArchiMetal взятой из официального репозитория archimate и сохраненной при помощи coArchi.

При запуске контейнера в среде GitHub Action или GitLab CI в HTML отчет также будут добавлены ссылки на другие отчеты включенные для генерации.

GitLab пайплайн

Для генерации отчета и публикации его в GitLab Pages необходимо создать файл .gitlab-ci.yml в корне проекта вашей coArchi модели, примерно с таким содержимым:

— pages: stage: build image: name: quay.io/woozymasta/archimate-ci-image:4.9.1-1.0.2 entrypoint: [«»] script: — /opt/Archi/entrypoint.sh variables: ARCHI_HTML_REPORT_ENABLED: «true» ARCHI_JASPER_REPORT_ENABLED: «true» ARCHI_JASPER_REPORT_FORMATS: «PDF,DOCX» ARCHI_CSV_REPORT_ENABLED: «false» ARCHI_EXPORT_MODEL_ENABLED: «true» rules: — if: $CI_COMMIT_BRANCH != null || $CI_PIPELINE_SOURCE == «merge_request_event» exists: — model/folder.xml artifacts: name: «$CI_JOB_NAME from $CI_PROJECT_NAME on $CI_COMMIT_REF_SLUG» expire_in: 30d paths: — public

После фиксации изменений в репозитории, у вас должен успешно выполнится пайплайн (пример), а модель опубликоваться в виде web-страницы (пример) в вашем GitLab Pages.

GitHub пайплайн

Для GitHub был реализован GitHub Action — Deploy Archi Report, который опубликует вашу модель на GitHub Pages из отдельной ветки gh-pages . Чтобы воспользоваться им вам достаточно создать файл в каталоге .github/workflows к примеру .github/workflows/main.yml с таким содержимым:

Зафиксировав изменения в репозитории, у вас должен успешно выполнится пайплайн (пример). После первого запуска вам также понадобится указать из какой ветки следует публиковать отчет, по умолчанию это gh-pages . Перейдите в настройки репозитория, в разделе Pages укажите исходную ветку gh-pages и используйте корневой каталог для поиска файлов, примените эти настройки.

После этого, публикация будет выполнятся из указанной вами ветки (пример) в вашем GitHub Pages.

На этом всё

Благодарю за ваше время и внимание! Успешных вам пайплайнов и актуальных моделей.

Присоединяйтесь в телеграмм канал, где я периодически публикую заметки на тему DevOps, SRE и архитектурных решений.

Источник: habr.com

Archi что это за программа

Оглавление
Оглавление
Базовые концепции ArchiMate
Зачем ArchiMate нужен НЕархитектору?
Дополнение модели в ArchiMate с помощью других инструментов
Михаил максимов

Чем полезен ArchiMate аналитику

ArchiMate стал всё чаще появляться в информационном поле, и всё больше бизнес-аналитиков отдают этому инструменту предпочтение в работе, используя его так же часто как UML и BPMN. Почему так?

Основное преимущество ArchiMate в том, что он как инструмент моделирования доступен аналитикам с любым уровнем подготовки и имеет понятный и простой синтаксис: как для создания модели, так и для её чтения.

В статье мы расскажем о возможностях и преимуществах ArchiMate и на примере покажем, как он может решать такие задачи бизнес-аналитиков, как разработка требований, работа с интеграциями и выстраивание эффективной коммуникации с заказчиками.

Материал будет интересен аналитикам уровня Middle и тем специалистам, которые хотят внедрить ArchiMate в свои проекты.

Время на чтение статьи: 13 минут
Не любите читать? Посмотрите видео.
Оглавление
Воркшоп «ArchiMate для проектирования и

поиска скрытых связей»

• Попробовать ArchiMate на практике.
• Моделировать архитектуру своих проектов с помощью инструмента Archi.
• Описывать бизнес и ИТ архитектуру, а также связи между ними.
• Связывать требования с элементами бизнес и ИТ архитектуры.
• Вносить изменения с учётом архитектуры.

Создание и развитие ArchiMate

ArchiMate — профессиональный язык моделирования, который создан специально для описания корпоративной архитектуры. Он предоставляет богатый набор структурных и поведенческих элементов для детального описания структуры и функционирования организации. Кроме того, он включает в себя набор ясно определëнных графических и грамматических правил, которые позволяют составлять архитектурные модели более эффективно.

Изначально ArchiMate был исследовательским проектом, который возглавлял Telematica Instituut в сотрудничестве с рядом организаций и университетов (Нидерланды). Работа над проектом продолжалась с июля 2002 года по декабрь 2004 года. После завершения проекта ArchiMate стал использоваться в таможенной и налоговой администрации Нидерландов, ABN AMRO и ABP Pension. Сейчас язык используют как архитекторы, чтобы описывать структуру компаний на верхнем уровне, так и аналитики — в качестве инструмента для упрощения конкретных задач.

У языка нет конкретного разработчика. ArchiMate (как концепция и как язык) поддерживается и развивается консорциумом Open Group. Компания выпускает обновления языка, фиксируют интересные кейсы и периодически публикует информацию на тему нотации.

Говоря об ArchiMate, стоит упомянуть и инструмент Archi. Archi — это набор кроссплатформенных инструментов моделирования, находящийся в свободном доступе. Репозиторий проекта можно найти на GitHub. Archi является эталонным продуктом по реализации языка ArchiMate.

Для чего используется ArchiMate

Одно из базовых назначений ArchiMate — объединение разрозненных представлений об архитектуре предприятия благодаря еë послойному представлению, где каждый слой показывает устройство уровней предприятия: стратегический уровень, бизнес-уровень, уровень приложений, технологический уровень и другие.

ArchiMate синхронизирован с методологией управления корпоративной архитектурой TOGAF, которая говорит про метод, про лучшие практики и, в целом, подход к тому, как выстраивать управление корпоративной архитектурой. TOGAF — это более общая концепция, общий фреймворк, который определяет, как на предприятии можно выстроить процесс работы с корпоративной архитектурой. ArchiMate же подключают для того, чтобы задать правила формирования контентной составляющей, указать какие артефакты строить и по каким правилам.

Подписаться на рассылку
Подпишитесь на рассылку, чтобы получать от нас полезные материалы и оставаться на связи

«Нажимая на кнопку, вы даете согласие на обработку персональных данных и соглашаетесь c политикой конфиденциальности»

Где ArchiMate применяют бизнес-аналитики

Рассмотрим некоторые типовые сценарии использования инструментов моделирования ArchiMate аналитиками.

Cпособ улучшения коммуникации. Моделирование позволяет вывести коммуникацию на новый уровень. Так, если в компании используется ArchiMate как единый язык для моделирования или взаимодействия, к примеру, с подрядчиками или с департаментом информационных технологий, то это позволяет уже не задумываться над формой, а сфокусироваться на содержании, что снижает риск искажения при взаимодействии.

Заведомо неудачное решение не станет лучше с использованием конкретно заданного шаблона, однако использование единого языка, единых правил, единой нотации снижает вероятность взаимного недопонимания между сторонами.

Более того, открывается возможность использовать мировую практику, перенимать опыт построения бизнес-систем у международных компаний, а также общаться с их представителями с помощью наглядной архитектуры со знакомым им синтаксисом, так как использование ArchiMate сейчас — это мировая тенденция.

Cпособ сохранения и накопления знаний. Также моделирование является инструментом, который позволяет сохранять, накапливать знания. Если определëнный процесс или структура чëтко смоделированы, то готовую модель можно использовать для погружения в проект новых лиц, для «вспоминания» определëнных процессов.

Упрощение процесса согласования. Модель, построенная в ArchiMate, является полезным и удобным инструментом для согласования. Нередко бывает, что многие, даже фундаментальные архитектурные решения принимаются путём многочасовых обсуждений, которые не имеют конечного результата. Использование ArchiMate позволяет предмету обсуждения приобрести форму, которая показывает взаимосвязь разных уровней бизнеса, их взаимодействие, важность и необходимость каждого элемента на каждом из уровней. Наглядность архитектуры сэкономит время обсуждения невероятных и трудно реализуемых идей.

Способ поиска уязвимостей и недоработок. Моделирование — это безусловно показательный и системный инструмент. Когда мы мыслим системно, когда существует проработанная схема и определëнные правила еë составления, наглядно видно, какие элементы были не учтены или указаны лишними. Тут ArchiMate приблизит момент, когда будет найдено слабое место в системе.

Базовые концепции ArchiMate

Прежде чем разбирать конкретные модели и элементы, их описания и прочее, стоит рассмотреть базовые концепции ArchiMate. Это позволит быстрее сориентироваться в инструменте и сделать вывод, насколько он подходит для выполнения ваших задач.

Послойное представление архитектуры в ArchiMate

Идея языка ArchiMate в том, чтобы представить всю деятельность предприятия в виде слоёв: начиная с самого верхнего слоя — Strategy — и заканчивая уровнем Physical, на котором могут моделироваться, к примеру, конкретные производственные линии конвейера.

Основные уровни в ArchiMate:

1. Business layer — описывает структуры, поведение и информацию об объектах, имеющих непосредственное отношение к людям, бизнес-процессам и продуктам, а также взаимоотношения между ними.

2. Application layer — моделирует структуру и поведение приложений, используемых предприятием для своевременной и целенаправленной обработки корпоративных данных.

3. Technology layer — уровень аппаратного обеспечения, который содержит элементы для описания структуры и поведения корпоративного ИТ-комплекса — узлы кластера, мультифункциональные устройства, сети передачи данных, инфраструктурные сервисы и системное программное обеспечение.

Цветовое обозначение слоя

Каждому слою (уровню) присвоен определенный цвет, например:

• Бизнес-архитектура отображается жёлтым цветом
• Архитектура приложений — голубым
• Уровень аппаратного обеспечения — зелёным

Разделение элементов по аспектам

Одним из базовых понятий языка является понятие «элемент». Элементы — это объекты, которые используются при моделировании. В ArchiMate они различаются по трём признакам (аспектам).

1. Первый аспект разделяет элементы языка на три типа: пассивный структурный элемент, элемент поведения и активный структурный элемент.

2. Второй аспект разделяет внутренние и внешние взгляды на системы. К примеру, внешним элементом может быть интерфейс, а внутренним — активный структурный элемент системы.

Распределение элементов языка по аспектам: структурный / поведенческий и внешний / внутренний
Аспекты;Активный структурный;Поведенческий;Пассивный структурный

Внешний;Интерфейс;Сервис;Объект системы Внутренний;Активный структурный элемент системы;Элемент поведения системы

3. Третий аспект описывает формат выполнения определенного действия: выполнение действия одним структурным элементом или коллективом (несколькими структурными элементами). Выделяют:

• активный структурный элемент — совместная деятельность (collaboration) как объединение структурных элементов для некоторого совместного действия (поведения / behavior)
• взаимодействие — непосредственно действие, выполняемое в рамках совместной деятельности двух или более структурных элементов

Пример

Рассмотрим подробнее первый аспект. Три его элемента можно представить как подлежащее, сказуемое и дополнение: кто делает действия, какие он выполняет действия и каким образом — с помощью каких инструментов.

Допустим, на уровне бизнес-слоя есть деятель (Actor), который является аспектом активной структуры (Active structure), выполняемый им процесс — это Behavior, пассивный объект (Passive structure) — это непосредственно концептуальный объект, над которым выполняется действие.

К примеру, сотрудник отдела страхования выписывает клиенту страховку. Сотрудник — элемент активной структуры, составление договора о страховании — это процесс, а клиент — элемент пассивной структуры.

Послойное представление архитектуры. Каноническое распределение слоев по цветам и по аспектам
Метамодель в основе языка

Слои в ArchiMate представляются в виде метамодели: используются представления отдельных элементов и разные типы связи между ними.

Метамодель в основе языка ArchiMate. Взаимодействие целевой составляющей (Why? What? Strategic view), архитектуры (How?) и составляющей практической реализации (When? By What?)

Типизация связей и способ их применения

Типы связей важно различать и правильно использовать: это позволит относительно легко оформлять разные типы отчëтов с помощью ПО Archi. Также с помощью Archi можно увидеть, правильно ли были установлены связи между элементами. Это происходит за счëт встроенных валидаций.

Типизация связей, которые используются в ArchiMate, и их способ применения

Понятия view и viewpoint

Следующая важная концепция ArchiMate — view и viewpoint.

Viewpoint (точка зрения) — это подмножество элементов и связей ArchiMate, объединëнных на диаграмме для представления определëнной части архитектуры. Они могут использоваться для просмотра определëнных аспектов изолированно и для связи двух или более аспектов.

View — это набор моделей, представляющих часть архитектуры с использованием концепций и взаимосвязей, соответствующих определенному viewpoint (точки зрения).

В качестве объекта может быть информационная система или предприятие в целом. Конечно, интереснее смотреть на предприятие в целом как на целостный объект. В случае моделирования предприятия для каждого стейкхолдера, либо для нескольких стейкхолдеров может быть определена точка, через которую они могут смотреть на этот объект. Это будет называться viewpoint. А то, что стейкхолдер в конечном итоге увидит через viewpoint — это view.

Так, в ArchiMate имеется определённое количество viewpoints — определённых порталов, через которые можно посмотреть на один объект. В них содержится определëнный набор необходимых элементов, метамодели, связи между элементами. В них нет лишних элементов и связей. Этот viewpoint будет чëтко описан с точки зрения того, для кого он, какие основные задачи с помощью него можно решить, посмотрев через него. Через viewpoint видна конкретная схема.

Если рассматривать дом, то, например, сантехники через определенный viewpoint видят схему водоснабжения в доме, электрики — схему электросетей.

Пример

В качестве иллюстрации рассмотрим городскую поликлинику, где есть определённое количество стейкхолдеров: главный врач, системный администратор, пациент и др. Также имеются, например, стандартные viewpoints, которые встроены в ArchiMate. К примеру, organization viewpoint, который передаëт информацию о том, как выглядит организационная структура предприятия. Через «Organization viewpoint» поликлиники будет видна схема сотрудников распределения по кабинетам и/или телефонный справочник с добавочными номерами.

Viewpoints удобно использовать в ситуациях, когда необходимо организовать доступ к информации про архитектуру. Viewpoints можно настроить один раз и далее выдавать к ним тот или иной доступ другому пользователю модели. Это помогает выстраивать некую ролевую модель доступа к описанию архитектуры.

Источник: systems.education