Bit with GitHub Actions

How to integrate Bit in your workflow with GitHub Actions.

npm install for public or private Bit components during CI (for projects that install components)

For installing public components you need to config the bit registry. To do so create an .npmrc file in your project's root directory, and place the following code inside:

@bit:registry=https://node.bit.dev
always-auth=true

For installing private components, you need to save your BIT_TOKEN in the repository settings.

Follow these steps to do this:

• Read how to create encrypted secrets for a repository.
• Create a new secret and name it BIT_TOKEN and then set your Bit token in the value. To get your token, run bit config get user.token on your local terminal.
• Update the .npmrc file to include the token registry:

@bit:registry=https://node.bit.dev
//node.bit.dev/:_authToken=${BIT_TOKEN}
always-auth=true

• Now use your secret in the main workflows file, read more about it.

bit export during CI

• Create your collection on bit.dev.
• Import the compiler you need.
• Import the tester you need.
• Track, tag and export components to your collection, Alert component for example.
• Create a new workflow file for bit export commands. Inside the file we need to do the following: configure Bit token, install Bit, run bit import, build&test, tag and export. Check out the workflows file I wrote about this, it will run when push to master are made(you can change/add branches it to your needs). Bit will tag components only if changes are made, and it will export and commit back to master the changes that are made to the .bitmap file.
• The components will be exported to the default scope that we can configure in the Bit config object inside the package.json file.

  "bit": {
    ...
    "defaultScope": "<username/organization>.<collection>"
  }
  

• When a new component is tracked locally, and then exported during the CI, Bit exports it to the default collection. (CI example)
• When a component's test fails in the CI, it is not exported. (CI example)

Run Bit build & test on PR's

When someone in your team made a change to a component, you want to be sure that everything is working well before exporting a new version of it.
For this, I wrote another workflows file, and it will run when pull requests are made to master (you can change/add branches it to your needs). After all the checks have passed, you can merge it.
Now, the bit export workflows file will run automatically, and it will export and commit back to master the changes that are made to the .bitmap file.

Open PR with success workflow example

Open PR with failure workflow example

Options

• Skip CI: skip bit export workflow by entering skip-ci in the commit message.