Настройка CI/CD между Yandex Cloud Functions и SourceCraft

Откройте главную страницу сервиса.

На панели слева нажмите Создать репозиторий.

В открывшемся окне выберите Пустой репозиторий.

В блоке Сведения о новом репозитории:

• В поле Владелец выберите организацию, в которой вы создали сервисный аккаунт в Yandex Cloud.

• В поле Название укажите название репозитория.

  Название должно быть уникальным в пределах организации и может содержать следующие ASCII-символы: строчные и заглавные буквы латинского алфавита, цифры, запятые, дефисы и подчеркивания.

  Под названием отображается адрес, по которому репозиторий будет доступен.

• (опционально) В поле Описание укажите описание репозитория.

В блоке Шаблон репозитория нажмите Просмотр шаблонов, выберите шаблон yc-cloud-functions-template и нажмите Использовать шаблон.

Чтобы посмотреть содержимое шаблона, нажмите Предварительный просмотр.

В шаблоне содержатся:

• файл .sourcecraft/ci.yaml с предустановленной конфигурацией CI/CD-процесса, который может быть запущен вручную для публикации функции в конкретной среде выполнения или автоматически для среды выполнения nodejs22 при создании коммита в основную ветку репозитория.
• директории с примерами кода функций для разных языков программирования и фреймворков.

Нажмите Создать репозиторий.

Откройте главную страницу SourceCraft.

Перейдите на вкладку Организации.

Выберите организацию, в которой вы создали сервисный аккаунт в Yandex Cloud.

На странице организации в разделе Настройки перейдите в секцию Сервисные подключения.

Нажмите Новое сервисное подключение.

В открывшемся окне:

• В блоке Базовая информация укажите имя сервисного подключения, например default-service-connection, опционально добавьте описание.

• В блоке Область применения выберите, для каких репозиториев и веток будет доступно сервисное подключение, например, выберите репозиторий, созданный ранее.

• В блоке Настройки Yandex Cloud выберите:

  • Каталог, на который вы назначили роль сервисному аккаунту.
  • Сервисный аккаунт, созданный ранее.

  Совет

  Чтобы повторно запросить список облаков, каталогов и сервисных аккаунтов из Yandex Cloud, нажмите Синхронизировать. Это может быть полезно, если параллельно с созданием сервисного подключения вы создали каталог или сервисный аккаунт.

Нажмите Создать сервисное подключение.

Дождитесь окончания операции. На открывшейся странице будут представлены детали сервисного подключения.

В Yandex Cloud будет автоматически создана федерация сервисных аккаунтов Yandex Identity and Access Management.

Чтобы посмотреть параметры созданного OIDC-провайдера, в блоке Федерация cервисных аккаунтов нажмите на имя федерации.

Откройте главную страницу SourceCraft.

На вкладке Домой в секции Ваша мастерская перейдите в раздел Репозитории.

Выберите созданный ранее репозиторий.

Выберите файл .sourcecraft/ci.yaml.

В правом верхнем углу нажмите Редактировать.

В рабочем процессе deploy-nodejs-function отредактируйте параметры создаваемой функции:

• YC_FUNCTION_NAME — имя функции, например test-function-nodejs.
• YC_FUNCTION_RUNTIME — среда выполнения, например nodejs22.
• YC_FUNCTION_ENTRYPOINT — точка входа функции, например index.handler. Задается в соответствии со средой выполнения согласно документации.
• SOURCE_PATH — путь в репозитории к коду функции, например ./nodejs.

Также вы можете добавить дополнительные параметры:

• ENVIRONMENT — переменные окружения для функции, например MY_ENV=SOURCECRAFT. Аналог параметра --environment для команды Yandex Cloud CLI yc serverless function version create.
• PUBLIC — сделать функцию доступной публично. Значение — true. Аналог команды Yandex Cloud CLI yc serverless function allow-unauthenticated-invoke.

В правом верхнем углу нажмите Сохранить изменения.

Сделайте коммит:

1. Введите сообщение об изменениях.
2. В блоке Ветка изменений выберите Сохранить непосредственно в ветку: main.
3. В блоке Действие после сохранения изменений выберите Просто сохранить.
4. Нажмите Сохранить изменения.

В консоли управления перейдите в каталог, в котором вы ранее создали сервисный аккаунт.

В списке сервисов выберите Cloud Functions.

В списке должна появиться функция test-function-nodejs, выберите ее.

В разделе История версий должна появиться версия функции, по времени создания соответствующая времени запуска CI/CD-процесса.

Перейдите на вкладку Редактор.

В редакторе кода в файле index.js должен отобразиться код:

// Example Node.js function handler
    export const handler = async function (event, context) {
        // Log the incoming event for debugging
        console.log('Received event:', event);

        // Access request body (if it's a POST request)
        const requestBody = event.body ? JSON.parse(event.body) : {};

        // Access query parameters
        const name = event.queryStringParameters ? event.queryStringParameters.name : 'World';

        return {
            statusCode: 200,
            headers: {
                'Content-Type': 'application/json',
            },
            body: JSON.stringify({
                message: `Hello, ${name}! Your request body was:`,
                data: requestBody,
            }),
        };
    };