Para ler a versão em Português, clique aqui.
На прошлой неделе мы представили кнопку Запустить проект.
Как мы уже говорили:
«Запустить проект» – это кнопка «Воспроизвести» для GitHub
Нажмите кнопку, и код, который вы только что видели в репозитории GitHub, будет запущен (безопасно!) на вашем локальном компьютере всего через несколько минут.
Проверьте учебник для подробной демонстрации.
Для этого вам необходимо установить azk. Как мы уже объясняли:
azk – оркестратор среды разработки.
azk можно использовать напрямую даже в проектах без "Выполнить проект" (или даже вне GitHub).
Мы создали azkдля отдельных разработчиков и небольших групп.
Неважно, говорим ли мы о новых проектах, созданных с нуля или о ранее существующих приложениях, azk автоматически устанавливает и настраивает для вас среды разработки.
azkможет управляться через интерфейс командной строки (интерфейс командной строки) и Azkfile.js.
Что такое Azkfile.js?
Инструкция по применению
Azkfile.js — это «руководство пользователя» приложения для azk.
Это простой файл манифеста, в котором перечислены компоненты архитектуры приложения и кратко описаны отношения между ними.
Он информирует azk об архитектуре, чтобы он мог подготовить среду и запустить необходимые системы.
Как видно из расширения, Azkfile.js основан на JavaScript — популярном, простом и легком для изучения синтаксисе. В любом случае, использование Azkfile.js с azk не требует каких-либо предварительных знаний о нем.
Проверьте этот пример Azkfile.js для настоящего приложения:
Как создать
Существует раздел о Azkfile.js в документации azk с кратким, но подробным объяснением того, как создать файл для вашего приложения.
В справочном разделе перечислены все параметры, поддерживаемые Azkfile.js, и способы их правильного использования.
Вы можете составить весь Azkfile.js с нуля самостоятельно, но это не обязательно. Вместо этого вы можете использовать команду `azk init` для azk.
Он может автоматически создать большую часть файла манифеста для вас. С этого момента вы можете вносить коррективы и дополнения, которые считаете необходимыми. Узнайте больше о `azk init` в этом разделе нашей документации.
Наконец, проверьте здесь инструкции о том, как создать кнопку Запустить проект для собственного репозитория на GitHub. На данный момент мы поддерживаем только публичные репозитории.
Другие преимущества
На данный момент мы узнали, что Azkfile.js является обязательным условием для использования Run Project на GitHub.
Кроме того, даже если проекта нет на GitHub, ему все равно нужен Azkfile.js, чтобы он мог работать на azk через интерфейс командной строки.
Что еще предлагает Azkfile.js вам как владельцу репозитория на GitHub или пользователю проекта?
- Документация;
- Отчеты об ошибках и имитация ошибок;
- Эволюция;
- Развертывание.
Документация
Помимо «руководства пользователя» приложения для azk, Azkfile.js также является пользовательской документацией.
Просто подумайте об этом на мгновение. ;)
Azkfile.js предлагает высокоуровневое представление архитектуры проекта.
Быстрого прочтения достаточно, чтобы узнать о его компонентах: языках или фреймворках, вспомогательных приложениях (например, рабочих), базах данных, службах кэширования и т. д. (и взаимосвязях между ними).
Отчеты об ошибках и имитация ошибок
Всякий раз, когда в вашем коде сообщается об ошибке, вы должны иметь возможность легко воспроизвести ее, чтобы разработать способ ее исправления.
Однако вполне возможно, что проблема связана с определенной конфигурацией среды на компьютере пользователя. Другая версия фреймворка, пропущенная библиотека, которая не была установлена, дополнительная (или отсутствующая) переменная окружения и… фуф!
Вы получили сообщение об несуществующей ошибке.
Хуже того: эта неприятная ошибка реальна, но вовлеченные в нее элементы на самом деле трудно обнулить и воспроизвести, или же они зависят от определенных настроек среды, которые могут быть установлены на компьютерах большего числа пользователей.
Навигация по всему этому далеко не тривиальна.
Слишком много времени может быть потрачено впустую на эти усилия. Это время, которое в противном случае можно было бы лучше потратить на создание потрясающих новых функций.
Поскольку Azkfile.js описывает полную архитектуру проекта, и каждый из его компонентов работает как служба в полностью изолированном контексте (контейнеры), конфигурации среды не повлиять на выполнение проекта.
Каждый пользователь, запускающий ваше приложение с помощью azk с использованием одного и того же файла Azkfile.js, будет работать с точно такой же конфигурацией.
Таким образом, всякий раз, когда вы получаете сообщение об ошибке, будет намного проще воспроизвести эту ошибку и внести исправление.
Эволюция
Azkfile.js предлагает новый язык для быстрой визуализации архитектуры приложений.
Это как рентгеновское зрение.
Вскоре вы поймете, что это упрощает получение понимания о наилучшем способе развития приложения (например, поиск перегруженных компонентов) и разработку тестов для возможных решений.
Вот еще один частый сценарий, в котором это имеет значение: при разделении изначально монолитного приложения или добавлении нового компонента (например, системы очередей для асинхронной обработки или новой поисковой системы) становится легче увидеть все архитектурные последствия этих изменений.
Есть много небольших преимуществ, подобных тем, которые в совокупности оказываются очень ценными.
Уровень уверенности, который вы вкладываете в каждое решение, намного выше.
Наконец, когда дело доходит до фактического внесения изменений в код, azk оптимизирует итерации в пиках, как мы видели ранее.
Развертывание
Развернуть приложение с помощью azk очень просто! Подробности см. в этом руководстве.
Все, что вам нужно сделать, это сделать простое дополнение к вашему Azkfile.js, и все готово.
Вывод
Что интересно в дополнительных преимуществах создания Azkfile.js для приложения, так это изначальное преимущество наличия Azkfile.js (возможность использовать “ Запустить проект» и azk).
Azkfile.js — это «живая» документация
Каждая отдельная реализация или изменение в ней приводит к тому, что можно описать только как «исполняемую» документацию (с гибкостью, автоматизацией и качеством).
Одно толкает другое.
Разработка программного обеспечения становится более упорядоченной и плавной. Наступает продуктивность и удовлетворение.
Вы будете тратить меньше времени на то, что не связано с кодом.
Программное обеспечение все больше и больше внедряется во все, что мы делаем. Как кто-то адекватно выразился:
Программное обеспечение пожирает мир
Итак, давайте просто кодировать!
На сегодня все, ребята. До встречи! ;)
Команда Азуки
Подробнее об азк
+ Сайт: http://azk.io
+ Github: https://github.com/azukiapp/azk
+ Документация: http://docs.azk.io
+ Каталог изображений, созданный командой azk: http://images.azk.io
Внести вклад в азк
+ Пометить azkнаGithub: https://github.com/azukiapp/azk
+ Сообщить о проблеме: https://github.com/azukiapp/azk/issues/new
+ Помогите решить заявленную проблему: https://github.com/azukiapp/azk/issues
+ Ознакомьтесь с нашими классные спонсоры: http://azk.io/#sponsors
Оставайтесь на связи с командой AZK
+ Подпишитесь на еженедельный дайджест: http://www.azk.io/#newsletter
+ Подпишитесь на блог: https://medium.com/azuki-news
+ Поговорите с наша поддержка (чат): https://gitter.im/azukiapp/azk (английский) и https://gitter.im/azukiapp/azk/pt (португальский)
+ Facebook: https ://www.facebook.com/azukiapp
+ Twitter: http://twitter.com/azukiapp
+ YouTube: «https://www.youtube.com/user/Azukiapp /видео"
