Configuring CI/CD between Yandex Cloud Functions and SourceCraft

Open the SourceCraft home page.

In the left-hand panel, click Create repository.

In the window that opens, select Blank repository.

Under Your new repository details:

• In the Owner field, select the organization in which you created the Yandex Cloud service account.

• In the Name field, specify a name for the repository.

  The name must be unique within the organization. The name may contain the following ASCII characters: lowercase and uppercase Latin letters, numbers, commas, hyphens, and underscores.

  The address to access the repository at is displayed below the name.

• Optionally, in the Description field, enter a description for the repository.

Under Repository template, click Browse templates. Select yc-cloud-functions-template and click Use template.

To view the template contents, click Preview.

The template contains:

• .sourcecraft/ci.yaml file with a pre-installed configuration of a CI/CD process you can run manually to publish your function to a specific runtime or automatically for the nodejs22 runtime when creating a commit to the repository main branch.
• Directories with function code examples for different programming languages and frameworks.

Click Create repository.

Open the SourceCraft home page.

Navigate to the Organizations tab.

Select the organization where you created the Yandex Cloud service account.

On the organization page, in the Settings section, go to the Service connections section.

Click New service connection.

In the window that opens, do the following:

• Under Basic information, give the connection a name, e.g., default-service-connection, and add an optional description.

• Under Scope, select the repositories and branches the service connection will be available to, e.g., the repository you created earlier.

• Under Yandex Cloud settings, select:

  • Folder for which you have assigned a role to the service account.
  • Service account you created earlier.

  Tip

  To re-request the list of clouds, folders, and service accounts from Yandex Cloud, click Synchronize. This can be of use if alongside creating a service connection you also created a folder or service account.

Click Create service connection.

Wait for the operation to complete. The page that opens will display the service connection details.

A Yandex Identity and Access Management workload identity federation will be automatically created in Yandex Cloud.

To view the parameters of the new OIDC provider, click the federation name under Workload identity federation.

Open the SourceCraft home page.

On the Home tab, under Your craftspace, navigate to Repositories.

Select the repository you created earlier.

Select .sourcecraft/ci.yaml.

In the top-right corner, click Edit.

In the deploy-nodejs-function workflow, edit the parameters of your new function:

• YC_FUNCTION_NAME: Function name, e.g., test-function-nodejs.
• YC_FUNCTION_RUNTIME: Runtime environment, e.g., nodejs22.
• YC_FUNCTION_ENTRYPOINT: Function entry point, e.g., index.handler. Specify it based on your runtime environment as described in this guide.
• SOURCE_PATH: Repository path to the function code, e.g., ./nodejs.

You can also add optional parameters:

• ENVIRONMENT: Environment variables for the function, e.g., MY_ENV=SOURCECRAFT. This is an equivalent of the --environment parameter in the yc serverless function version create Yandex Cloud CLI command.
• PUBLIC: Make the function publicly available. This parameter takes the true value. This is an equivalent of the yc serverless function allow-unauthenticated-invoke Yandex Cloud CLI command.

In the top-right corner, click Commit changes.

Commit:

1. Enter a message about the changes.
2. Under Commit branch, select Commit directly to the branch: main.
3. Under After commit action, select Just commit.
4. Click Commit changes.

In the management console, go to the folder where you previously created the service account.

In the list of services, select Cloud Functions.

The list should now contain test-function-nodejs. Select it.

Under Version history, you should now see the function's version with the same timestamp as the CI/CD process execution.

Navigate to the Editor tab.

In the code editor, index.js should now feature this code:

// 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,
            }),
        };
    };