Skip to content
Permalink
Branch: master
Find file Copy path
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
53 lines (41 sloc) 1.96 KB
title tag summary redirect_from menu
Running your first local build
cli
builds
bitrise
Run your first offline build using the Bitrise CLI. You need the CLI itself and a `bitrise.yml` file that contains a valid configuration. You can download the file or create it yourself.
bitrise-cli-main
weight
18

To run a Bitrise build locally, you only need two things:

  1. The Bitrise CLI - here's our installation guide.
  2. A build configuration: that is, a bitrise.yml file. Read more about it in our guide.

If you use bitrise.io, you can download your app's bitrise.yml from there: open the Workflow Editor of the app on bitrise.io, under the bitrise.yml section.

If you want to create a bitrise.yml yourself, simply create a bitrise.yml file in the root of your project. You can use this as the base content of the bitrise.yml:

format_version: 1.3.1
default_step_lib_source: https://github.com/bitrise-io/bitrise-steplib.git

app:
  envs:
  - MY_NAME: My Name

workflows:
  test:
    steps:
    - script@1.1.3:
        inputs:
        - content: echo "Hello ${MY_NAME}!"

This defines an Environment Variable with your name and a workflow called test. Now let's see how to run this build!

  1. Open the Terminal or some other Command Line Interface app.

  2. Go to the directory where you saved the bitrise.yml file.

  3. Run bitrise run with the name of the workflow you defined in the file.

    bitrise run test
    

That's it! Your first build is running with the Bitrise CLI!

Now you know everything
Go to Bitrise now
You can’t perform that action at this time.