AWS CodeCommit Integration: Automate localization tasks with Crowdin CLI

Use AWS CodeCommit in combination with CodePipeline + CodeBuild and Crowdin CLI to automate your common localization tasks such as uploading source files, downloading translations or anything else you can do with Crowdin CLI.

Thing you need to have set up in your AWS Console:

• CodeCommit repository
• CodeBuild project
• CodePipeline pipeline

Preparing the CodeCommit repository

Push the crowdin.yml configuration file to the repository.

Use Environment Variables for API Credentials:

"project_id_env": "CROWDIN_PROJECT_ID"
"api_token_env": "CROWDIN_PERSONAL_TOKEN"

You will also need to set up the buildspec.yml configuration file for CodeBuild:

version: 0.2

phases:
  install:
    runtime-versions:
      nodejs: 16.x
    commands:
      - npm install -g @crowdin/cli
  build:
    commands:
      - crowdin -V
      - crowdin status --no-progress
      - crowdin push --no-progress
      - crowdin pull --no-progress

In this example, the pipeline will be triggered on branch push. Then you need to set up Node and install Crowdin CLI NPM package globally. After the CLI installation, you can execute any CLI command.

Then you can commit and push new translations to your CodeCommit repository.

For more about buildspec.yml see the Build specification reference for CodeBuild docs.

Setting up a CodeBuild project

• For Source provider select AWS CodeCommit
• For Repository choose your CodeCommit repository you need to sync translations with
• Fill in the Branch name and other options according to your needs
• In the Environment section:
  • select Ubuntu runtime since it already contains the development tools (recommended)
  • add the following environment variables: CROWDIN_PROJECT_ID, CROWDIN_PERSONAL_TOKEN

Setting up a CodePipeline pipeline

• For Source provider select AWS CodeCommit
• For Repository choose your CodeCommit repository you need to sync translations with
• Fill in the Branch name and other options according to your needs
• For Build provider select the previously created CodeBuild project

For more information about Crowdin CLI commands visit the official Crowdin CLI website.