# AWS CodeCommit

> Automate your frequent localization tasks such as uploading source files and downloading translations.

URL: https://store.crowdin.com/codecommit
Category: Development
Type: Guide
Author: Andrii Bodnar

Use AWS CodeCommit in combination with CodePipeline + CodeBuild and [Crowdin CLI](https://crowdin.github.io/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](https://aws.amazon.com/codecommit/) repository
- [CodeBuild](https://aws.amazon.com/codebuild/) project
- [CodePipeline](https://aws.amazon.com/codepipeline/) pipeline

### Preparing the CodeCommit repository

Push the `crowdin.yml` [configuration file](https://developer.crowdin.com/configuration-file/) to the repository.

Use Environment Variables for API Credentials:

```yml
"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:

```yml
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](https://www.npmjs.com/package/@crowdin/cli) 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](https://docs.aws.amazon.com/codebuild/latest/userguide/build-spec-ref.html) 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](https://crowdin.github.io/crowdin-cli/).