Rivalry2

HTML Diff

0 added 0 removed

Original 2026-01-01

Modified 2026-02-19

1 Эта статья продолжает цикл переводных заметок об OpenWhisk от автора <a>Priti Desai</a>. Сегодня рассмотрим примеры развертывания Zip-функций, зависимости GitHub, а также подробнее опишем синхронизацию объектов между клиентом и сервером OpenWhisk.<h2>Zip-функции</h2>

2 OpenWhisk поддерживает создание функции из единственного файла с исходным кодом, как это было [показано ранее](). Он же поддерживает создание функции с использованием нескольких файлов с исходным кодом и набором пакетов, от которых функция зависит. Этот вариант использования функций называется zip-функцией. Давайте попробуем развернуть zip-функцию с помощью wskdeploy.<h3>Шаг первый</h3>

3 Создаем файл-манифест:<blockquote>packages:</blockquote><blockquote> zipaction:</blockquote><blockquote> actions:</blockquote><blockquote> my-zip-action:</blockquote><blockquote> function: actions/my-zip-action</blockquote><blockquote> runtime: nodejs:6</blockquote><blockquote> inputs:</blockquote><blockquote> name: Amy</blockquote>Считаем, что my-zip-action имеет такую структуру каталога, содержащую исходный код функции:<blockquote>$ ls actions/my-zip-action</blockquote><blockquote>index.js</blockquote><blockquote>package.json</blockquote>Содержимое файла index.js:<blockquote>function helloworld(params) {</blockquote><blockquote> var format = require('string-format');</blockquote><blockquote> var name = params.name || 'Stranger';</blockquote><blockquote> payload = format('Hello, {}!', name)</blockquote><blockquote> return { message: payload };</blockquote><blockquote>}</blockquote><blockquote>exports.main = helloworld;</blockquote>Содержимое файла package.json:<blockquote>{</blockquote><blockquote> "name": "my-zip-action",</blockquote><blockquote> "description": "Node OpenWhisk zip action to demo Whisk Deploy",</blockquote><blockquote> "license": "Apache-2.0",</blockquote><blockquote> "version": "1.0.0",</blockquote><blockquote> "main": "index.js",</blockquote><blockquote> "dependencies": {</blockquote><blockquote> "string-format": "0.5.0"</blockquote><blockquote> }</blockquote><blockquote>}</blockquote><h3>Шаг второй</h3>

4 Запускаем npm install для установки string-format:<blockquote>cd actions/my-action</blockquote><blockquote>npm install --production</blockquote><h3>Шаг третий</h3>

5 Разворачиваем zip-функцию:<a>Скопировать код</a>Мы развернули zip-функцию my-zip-action с зависимым модулем string-format. При указании каталога в манифесте по ключу function создается zip-архив из этого каталога, а также - функция из этого архива, так что не надо искать его по файловой системе. После развертывания можно работать с новой функцией точно так же, как и с другими функциями.

6 <h2>Include и exclude для файлов в zip-функциях</h2>

7 OpenWhisk позволяет создавать функцию с использованием zip-архива, содержащего любое количество файлов для функции, в т.ч. все ее зависимости. Развертывание поддерживает указание в function каталога с файлами для работы функции. Из содержимого каталога будет создан архив, из которого уже будет развернута функция.<h3>Включение файлов</h3>

8 Ранее была представлена возможность указать ключ include, работающий примерно так же, как import в языках программирования, что позволило, к примеру, нескольким функциям ссылаться на одну общую библиотеку с кодом:<blockquote>$ cd actions/</blockquote><blockquote>$ ls -1 ./</blockquote><blockquote>common/</blockquote><blockquote>greeting1/</blockquote><blockquote>greeting2/</blockquote><blockquote>manifest.yaml</blockquote><blockquote>$ ls -1 common/</blockquote><blockquote>utils.js</blockquote><blockquote>$ ls -1 greeting1/</blockquote><blockquote>index.js</blockquote><blockquote>package.json</blockquote><blockquote>$ ls -1 greeting2/</blockquote><blockquote>index.js</blockquote><blockquote>package.json</blockquote>Можно видеть файл index.js в каталоге greeting1, а также еще один index.js в каталоге greeting2, и оба ссылаются на utils.js, расположенный в common/.Содержимое файла index.js, расположенного в actions/greeting1/:

9 <a>Скопировать код</a>Содержимое файла index.js, расположенного в actions/greeting2/:

10 <a>Скопировать код</a>Внутри ключа include содержится список файлов или каталогов, которые должны быть включены в функцию. Каждый элемент этого списка должен иметь source и\или destination, к примеру:

11 <blockquote>include:</blockquote><blockquote> - [source]</blockquote><blockquote> - [source, destination]</blockquote>Примечания:<ul><li>source содержит относительный путь от каталога, содержащего manimanifest.yaml. destination подразумевает относительный путь от каталога с функцией, к примеру actions/greeting1 и actions/greeting2 в следующем примере.</li>

12 <li>Если параметр destination не задается - считается что он будет такой же, как и source.</li>

13 </ul>Содержимое файла-манифеста:<a>Скопировать код</a>include работает с различными сочетаниями source и destination:

14 <ul><li>просто source:</li>

15 </ul><blockquote>include:</blockquote><blockquote> - [actions/common/utils.js]</blockquote>При такой записи utils.js будет скопирован в actions/greeting/actions/common/utils.js, а index.js может сослаться на него так:<blockquote>var utils = require('./actions/common/utils.js')</blockquote><ul><li>include с переименованием:</li>

16 </ul><blockquote>include:</blockquote><blockquote> - ["actions/common/utils.js", "./common/myUtils.js"]</blockquote>С таким определением utils.js будет помещен по пути actions/greeting/common/myUtils.js, а index.js будет ссылаться на него так:<blockquote>var utils = require('./common/myUtils.js')</blockquote><ul><li>include с другим путём:</li>

17 </ul><blockquote>include:</blockquote><blockquote> - ["actions/common/utils.js", "./common/utility/utils.js"]</blockquote>В таком случае utils.js будет скопирован в actions/greeting/common/utility/utils.js, со ссылкой из index.js:<blockquote>var utils = require('./common/utility/utils.js')</blockquote><ul><li>include с символом *:</li>

18 </ul><blockquote>include:</blockquote><blockquote> - ["actions/common/*.js", "./common/"]</blockquote>В этом варианте utils.js вместе с другими файлами с расширением .js будет скопирован в каталог actions/greeting/common/, а в index.js эти файлы будут подключаться так:<blockquote>var utils = require('./common/utils.js')</blockquote><h3>Включение каталогов</h3>

19 В include можно прописать каталог, который будет рекурсивно скопирован в указанное место перед включением в архив. Например libs`` содержит список библиотек, на которые ссылаетсяindex.jsв подкаталогеgreeting3/```:<blockquote>$ cd actions/</blockquote><blockquote>$ ls -1</blockquote><blockquote>libs/</blockquote><blockquote>greeting3/</blockquote><blockquote>manifest.yaml</blockquote><blockquote>$ ls -1 libs/</blockquote><blockquote>lib1/</blockquote><blockquote>lib2/</blockquote><blockquote>lib3/</blockquote><blockquote>$ ls -1 libs/lib1/</blockquote><blockquote>utils.js</blockquote><blockquote>$ ls -1 libs/lib2/</blockquote><blockquote>utils.js</blockquote><blockquote>$ ls -1 libs/lib3/</blockquote><blockquote>utils.js</blockquote><blockquote>$ ls -1 greeting3/</blockquote><blockquote>index.js</blockquote><blockquote>package.json</blockquote>Содержимое index.js в каталоге actions/greeting3/:<a>Скопировать код</a>Содержимое файла-манифеста:

20 <blockquote>packages:</blockquote><blockquote> zipactionwithinclude:</blockquote><blockquote> actions:</blockquote><blockquote> greeting3:</blockquote><blockquote> function: actions/greeting3</blockquote><blockquote> runtime: nodejs:6</blockquote><blockquote> include:</blockquote><blockquote> - ["actions/libs/*", "libs/"]</blockquote>В этом примере каталог libs целиком рекурсивно копируется в actions/greeting3/libs/.Подключение каталогов с символом *:

21 <ul><li>пример 1:</li>

22 </ul><blockquote>include:</blockquote><blockquote> - ["actions/libs/*/utils.js", "libs/"]</blockquote>При таком написании будут скопированы из libs все подкаталоги, содержащие utils.js. Ссылки из index.js будут выглядеть так:<blockquote>var lib1 = require('./libs/lib1/utils.js')</blockquote><blockquote>var lib2 = require('./libs/lib2/utils.js')</blockquote><blockquote>var lib3 = require('./libs/lib3/utils.js')</blockquote><ul><li>пример 2:</li>

23 </ul><blockquote>include:</blockquote><blockquote> - ["actions/*/*/utils.js"]</blockquote>При такой записи будут скопированы все подкаталоги, подходящие под маску и содержащие utils.js. Доступ из index.js будет таким:<blockquote>var lib1 = require('./actions/libs/lib1/utils.js')</blockquote><blockquote>var lib2 = require('./actions/libs/lib2/utils.js')</blockquote><blockquote>var lib3 = require('./actions/libs/lib3/utils.js')</blockquote><ul><li>пример 3:</li>

24 </ul><blockquote>include:</blockquote><blockquote> - ["actions/*/*/utils.js", "actions/"]</blockquote>В этом примере явно указано, куда все скопируется. Доступ из index.js будет таким же, как и в предыдущем примере.<h2>Исключение</h2>

25 Ключевое слово exclude может использоваться в виде списка файлов и каталогов, разрешено использовать маску в виде символа *. Пример использования:<blockquote>exclude:</blockquote><blockquote> - actions/common/*.js</blockquote><blockquote> - actions/libs/*/utils.js</blockquote>Общий пример совместного использования include и exclude:<a>Скопировать код</a><h2>Функции с GitHub зависимостями</h2>

26 OpenWhisk поддерживает зависимости, так что можно описать другие пакеты OpenWhisk, от которых зависит наш проект. При наличии таких зависимостей OpenWhisk автоматически развернет и зависимые пакеты. Любой пакет с manifest.yaml и\или deployment.yaml можно рассматривать как зависимый пакет, который может быть указан в манифесте нашего проекта. Можно описать такую зависимость в манифесте в разделе dependencies:<a>Скопировать код</a>В этом примере helloworlds является внешним пакетом, размещенным в репозитории GitHub по адресу <a>https://github.com/apache/incubator-openwhisk-test</a>. Пакет helloworlds будет развернут, исходя из его файлов для развертывания в каталоге packages/helloworlds - при развертывании нашего проекта RootProject. Также есть возможность смены имени зависимого пакета, например вместо helloworlds задать ChildProject:

27 <a>Скопировать код</a>Можно добавить несколько зависимостей к нескольким пакетам:

28 <a>Скопировать код</a><h2>Как работает синхронизация проектов OpenWhisk между клиентом и сервером</h2>

29 Для ответа надо запустить развертывание в режиме managed deployment. В этом режиме OpenWhisk производит развертывание всех объектов из манифеста, а также присоединяет к каждому из них скрытое описание, т.н. managed. Это описание можно посмотреть<a>по ссылке.</a>Вариант 1: Если __OW_PROJECT_HASH совпадает на клиенте и сервере, т.е. если нет изменений проекта на клиентской стороне, то проект на сервере остается как есть, за исключением развертывания через wskdeploy новых объектов из манифеста для получения любых изменений в файле deployment.yaml.

30 Вариант 2: Если __OW_PROJECT_HASH не совпадает, т.е. имеются изменения на стороне клиента, то wskdeploy выполняет развертывание всех объектов из манифеста, а затем обновляет их __OW_PROJECT_HASH на сервере. Также wskdeploy выполняет поиск всех объектов: включая функции, последовательности и условные срабатывания, у которых такой же __OW_PROJECT_NAME, - т.е. принадлежащих тому же проекту, но имеющих другой __OW_PROJECT_HASH, поскольку они могли быть удалены из манифеста на клиенте. Имя проекта в манифесте является обязательным для синхронизации проекта между клиентом и сервером:

31 <blockquote>project:</blockquote><blockquote> name: MyProjectName</blockquote><blockquote> packages:</blockquote><blockquote> package1:</blockquote><blockquote> ....</blockquote>Объекты в OpenWhisk, являющиеся частью проекта, но для которых выполняется развертывание с использованием других инструментов или средств автоматизации, остаются неизменными при их удалении из проекта. Они считаются внешними объектами и поэтому не перезаписываются. Развернуть такой проект можно с помощью wskdeploy, направляя его на файл манифеста, в котором есть только имя проекта:<blockquote>project:</blockquote><blockquote> name: MyProjectName</blockquote>Давайте посмотрим на пример проекта для понимания managed deployment. В <a>этом репозитории</a> можно посмотреть проект с различными манифестами, которые показывают managed deployment.<h3>Шаг первый</h3>

32 Выполняем развертывание MyFirstManagedProject, используя режим managed deployment:<blockquote>$wskdeploy -m tests/src/integration/managed-deployment/manifest.yaml --managed</blockquote><blockquote>Deployment completed successfully.</blockquote>Список объектов, развернутых на сервере OpenWhiskОписание объекта<h3>Шаг второй</h3>

33 Синхронизируем клиент и сервер - удаляем ManagedPackage-<a>2: https://xpaste.pro/p/5xm4eUso</a>Список объектов после удаления в MyFirstManagedProject<h3>Шаг третий</h3>

34 Синхронизируем клиент и сервер - удаляем последовательность ManagedSequence-<a>2: https://xpaste.pro/p/0E82P8r4</a>Список объектов после удаления<h3>Шаг четвертый</h3>

35 Удаляем функцию Helloworld-3: <a>https://xpaste.pro/p/xjm1tvPT</a>Список объектов после удаления<h3>Шаг пятый</h3>

36 Удаляем ManagedPackage-1: <a>https://xpaste.pro/p/JZAfllFV</a>Остальные объекты в MyFirstManagedProject<h3>Другие статьи цикла</h3>

37 <a>Бессерверные вычисления на основе OpenWhisk, часть 1</a><a>Бессерверные вычисления на основе OpenWhisk, часть 2</a><a>Бессерверные вычисления на основе OpenWhisk, часть 4</a>