step.yml

title: |-
  Azure DevOps status
summary: |
  Update commit status for Azure DevOps repositories
description: |
  Update commit status for Azure DevOps repositories.
  This step always runs, no matter if build succeeded or failed.
website: https://github.com/mediusoft/bitrise-step-azure-devops-status
source_code_url: https://github.com/mediusoft/bitrise-step-azure-devops-status
support_url: https://github.com/mediusoft/bitrise-step-azure-devops-status/issues
host_os_tags:
  - osx-10.10
  - ubuntu-16.04

type_tags:
  - utility

is_requires_admin_user: false
is_always_run: true
is_skippable: true
run_if: not (enveq "BITRISE_GIT_COMMIT" "")

deps:
  brew:
  - name: curl
  apt_get:
  - name: curl

toolkit:
  bash:
    entry_file: step.sh

inputs:
  - devops_user: $AZURE_DEVOPS_USER
    opts:
      title: Azure DevOps user name
      description: |
        Azure DevOps user name.

        Can also be taken from secret `AZURE_DEVOPS_USER`. Cannot be empty.
      is_sensitive: true
      is_expand: true
      is_required: true

  - devops_pat: $AZURE_DEVOPS_PAT
    opts:
      title: Azure DevOps Personal Access Token
      description: |
        Azure DevOps Personal Access Token.

        Can also be taken from secret `AZURE_DEVOPS_PAT`. Cannot be empty.
      is_sensitive: true
      is_expand: true
      is_required: true

  - devops_organization: $AZURE_DEVOPS_ORGANIZATION
    opts:
      title: Azure DevOps organization
      description: |
        Azure DevOps organization.

        Can also be taken from env var `AZURE_DEVOPS_ORGANIZATION`. Cannot be empty.
      is_expand: true
      is_required: true

  - devops_project: $AZURE_DEVOPS_PROJECT
    opts:
      title: Azure DevOps project
      description: |
        Azure DevOps project.

        Can also be taken from env var `AZURE_DEVOPS_PROJECT`. Cannot be empty.
      is_expand: true
      is_required: true

  - devops_repository_id: $AZURE_DEVOPS_REPOSITORY_ID
    opts:
      title: Azure DevOps repository ID
      description: |
        Azure DevOps repository ID.

        Can also be taken from env var `AZURE_DEVOPS_REPOSITORY_ID`. Cannot be empty.
      is_expand: true
      is_required: true

  - devops_commit_state: "auto"
    opts:
      title: Commit status
      description: |
        Status to set on commit.

        Possible values are `auto`, `error`, `failed`, `notApplicable`, `notSet`, `pending`, `succeeded`.
        If set to `auto` then step will automatically set `succeeded` or `failed` based on build status.
      is_expand: true
      is_required: true
      value_options:
        - "auto"
        - "pending"
        - "succeeded"
        - "failed"
        - "error"
        - "notSet"
        - "notApplicable"

  - devops_description: ""
    opts:
      title: Commit status description
      description: |
        Status description.

        Typically describes current state of the status. 
        If no value provided, then will be set to `$BITRISE_APP_TITLE build #$BITRISE_BUILD_NUMBER $state`.
      is_expand: true
      is_required: false

  - devops_target_url: $BITRISE_BUILD_URL
    opts:
      title: Target URL
      description: |
        URL with status details.

        This URL will be opened when status description is clicked from Azure DevOps. Cannot be empty
      is_expand: true
      is_required: true

  - devops_context_name: build/$BITRISE_APP_TITLE
    opts:
      title: Name identifier
      description: |
        Name identifier of the status.

        Typically name of the build pipeline/configuration. Cannot be empty.
      is_expand: true
      is_required: true

  - devops_context_genre: continuous-integration
    opts:
      title: Status genre
      description: |
        Genre of the status.

        Typically name of the service/tool generating the status. Can be empty.
      is_expand: true
      is_required: false

outputs: