bitrise-step
Steps and Workflows are the heart of how Bitrise works. A Bitrise build is simply a series of Steps. Bitrise is a collection of tools and services to help you with the development and automation of your software projects, with a main focus on mobile apps
step.ymlCheck your file against this schema
Opens the validator with this schema already loaded. Paste your
step.yml and it validates in your browser — nothing is uploaded.
Fields
Generated directly from the schema, following local
$refs, to two levels of nesting.
| Field | Type | Description |
|---|---|---|
title | string | The human-readable title of the Step. |
summary | string | A short summary of what the Step does. |
description | string | A more detailed overview of the Step's function and configuration. |
website | string | A web URL where users can find more information about the Step or the tools and services it implements. |
source_code_url | string | The URL of the repository of the Step's source code. |
support_url | string | A URL where users can get support for the Step. |
published_at | string | The date and time when the Step was published to the Step Library. This is auto-generated and should not be set manually. |
source | object | — |
source.git | string | The Git repository URL of the Step's source code. |
source.commit | string | The commit hash for the version tag of the Step's current version. |
asset_urls | object | URLs of assets associated with the Step, such as icon images. This is auto-generated and only set in the spec.json file in the Step Library. |
host_os_tags | array<string> | This property defines the host operating systems the Step is compatible with. For example, `linux` or `macos`. |
project_type_tags | array<string> | This property defines the project type category of the Step. For example, `flutter` or `ios`. |
type_tags | array<string> | This property defines the functional category of the Step. For example, `utility`, `test`, or `notification`. |
dependencies | array | The dependencies required by the Step. |
toolkit | object | — |
toolkit.bash | object | — |
toolkit.bash.entry_file | string | The path to the bash script file that serves as the entry point for the Step. |
toolkit.go | object | — |
toolkit.go.package_namerequired | string | The name of the Go package that serves as the entry point for the Step. |
deps | object | — |
deps.brew | array | List of Homebrew dependencies required by the Step. |
deps.apt_get | array | List of apt-get dependencies required by the Step. |
deps.check_only | array | List of dependencies that are only checked for existence. |
is_requires_admin_user | boolean | If this property is true, the Step requires admin user privileges to run. |
is_always_run | boolean | If this property is true, the Step will always run, even if a previous Step in the Workflow failed. |
is_skippable | boolean | If this property is true, the build won't fail even if this Step fails. For example, if a Step restoring a cache archive fails, you might still want to run the build. |
run_if | string | This property sets conditions for running a Step. It requires boolean value or a valid Go template expression. |
timeout | integer | This property defines a time limit for a Step: if the Step runs longer than the defined time, the Step fails. Define the limit in seconds. |
no_output_timeout | integer | This property defines a time limit for a Step that produces no output: if the Step runs for the defined number of seconds without producing any output, the Step fails. Define the limit in seconds. |
meta | object | Additional metadata related to the Step. |
execution_container | oneOf | A reference to a container. Can be specified as a container ID string or as an object with the container ID as the key and optional configuration as the value. |
service_containers | array | Service containers to run alongside this Step as background services. |
inputs | array<object> | The inputs of the Step. |
outputs | array<object> | The outputs the Step generates. |
executables | object | Platform-specific executable binaries |
What we found in this schema
- Declared draft: draft-07
- Validates cleanly against its own meta-schema.
- Has 1 place(s) where keywords sit beside
$ref. Under draft-07 those keywords are silently ignored by every conforming validator — first at#. - 46 properties, 100% carrying a description, max nesting depth 8.
Specification sections for the keywords in this schema
| Keyword | Document | Section |
|---|---|---|
$id | JSON Schema Core, draft 2020-12 | §8.2.1 — The "$id" Keyword |
$ref | JSON Schema Core, draft 2020-12 | §8.2.3.1 — Direct References with "$ref" |
$schema | JSON Schema Core, draft 2020-12 | §8.1.1 — "$schema" |
additionalProperties | JSON Schema Core, draft 2020-12 | §10.3.2.3 — "additionalProperties" |
description | JSON Schema Validation, draft 2020-12 | §9.1 — "title" and "description" |
items | JSON Schema Core, draft 2020-12 | §10.3.1.2 — "items" |
maxProperties | JSON Schema Validation, draft 2020-12 | §6.5.1 — "maxProperties" |
minProperties | JSON Schema Validation, draft 2020-12 | §6.5.2 — "minProperties" |
oneOf | JSON Schema Core, draft 2020-12 | §10.2.1.3 — "oneOf" |
patternProperties | JSON Schema Core, draft 2020-12 | §10.3.2.2 — "patternProperties" |
properties | JSON Schema Core, draft 2020-12 | §10.3.2.1 — "properties" |
required | JSON Schema Validation, draft 2020-12 | §6.5.3 — "required" |
type | JSON Schema Validation, draft 2020-12 | §6.1.1 — "type" |
format: "date-time" | RFC 3339 | §5.6 — Internet Date/Time Format |
Documents
- JSON Schema Core, draft 2020-12 — JSON Schema: A Media Type for Describing JSON Documents, A. Wright, H. Andrews, B. Hutton, G. Dennis, Eds., 2022. draft-bhutton-json-schema-01. An expired Internet-Draft with no formal standing in the IETF standards process; it is nonetheless the specification of record for JSON Schema 2020-12, published by json-schema.org.
- JSON Schema Validation, draft 2020-12 — JSON Schema Validation: A Vocabulary for Structural Validation of JSON, A. Wright, H. Andrews, B. Hutton, Eds., 2022.
- RFC 8259 (STD 90) — The JavaScript Object Notation (JSON) Data Interchange Format, T. Bray, Ed., 2017. The format a schema describes.
- RFC 6901 — JavaScript Object Notation (JSON) Pointer. Defines the pointer syntax used by $ref fragments and the ~0 / ~1 escapes.
Attribution
This schema comes from SchemaStore, distributed under the Apache License 2.0. Copyright 2015–present Mads Kristensen and contributors. View the original file. The field table and audit on this page are generated by JSONTools.tools; the schema itself is unmodified.