Bitbucket Pipelines を使い始める

Bitbucket Pipelines is an integrated CI/CD service, built into Bitbucket. It allows you to automatically build, test and even deploy your code, based on a configuration file in your repository. Essentially, we create containers in the cloud for you. Inside these containers you can run commands (like you might on a local machine) but with all the advantages of a fresh system, custom configured for your needs.

Pipelines をセットアップするには、リポジトリのルート ディレクトリで bitbucket-pipelines.yml ファイルを作成して構成する必要があります。このファイルがビルド構成であり、構成をコードとして使用することでバージョンが管理され、ほかのコードと常に同期されます。

bitbucket-pipelines.yml ファイルには、リポジトリのすべてのビルド構成が含まれます。YAML は読み取りやすいファイル形式ですが、書き込みを行う際には注意が必要です。タブ文字は使用できないため、インデントにはスペースを使用する必要があります。

bitbucket-pipelines.yml ファイルで構成できることは多数ありますが、最も基本となる必須キーワードは次のとおりです。

pipelines: すべてのパイプライン定義が含まれます。

default: 各プッシュで実行するステップが含まれます。

step: 各ステップはリポジトリのクローンの新しい Docker コンテナで開始され、その後、script セクションのコンテンツを実行します。

script: 連続して実行されるコマンドのリストです。

ステップ 1: 言語テンプレートを選択する

ビルドは Docker コンテナ上で実行されるため、Pipelines では Linux で実行可能なあらゆるコードを構築およびテストできます。一般的な言語やプラットフォーム (PHP、JavaScript/Node.js(npm)、Java (Maven/Gradle)、Python、Ruby、C#、C++ (make) など) で開始するのに役立つテンプレートを利用できます。

  1. 左側のナビゲーション バーから [Pipelines] を選択します。
  2. 使用したい言語テンプレートを選択します。 

言語が表示されない場合でも、問題ありません。必要な内容が表示されない場合、[詳細] メニューの [その他] オプションを選択します。これは多くの一般的なビルド ツールを含む既定の Docker イメージを使用し、スクリプトで apt-get コマンドを使用して独自のツールを追加できます。




ステップ 2: パイプラインを構成する

bitbucket-pipelines.yml ファイルを編集して、ソフトウェアのビルドに必要なコマンドを含める必要があります。

  1. エディタを使用し、要件に合わせてファイルをカスタマイズします。

    構成例を参照する

    コンテナの python のバージョンをチェックするためのコマンドを実行する基本的な構成は、次のようになります。

    pipelines:
      default:
        - step:
            script:
              - python --version

    ビルドとテストに使用するコマンドで、スクリプト セクションのコンテンツを置き換えます。実行するコマンドがほとんどない場合、別のスクリプト ファイルにそれらを配置して、コードから呼び出すこともできます。

    コードをビルドおよびテストした後、ステージング環境にビルドをデプロイする別の手順が必要な場合があります。これは手動でトリガーできるようになっているため、Pipelines ページでボタンをクリックしてデプロイできます。

    pipelines:
      default:
        - step:
            name: Build and test
            script:
              - python build-test.py
        - step:
            name: Deploy to staging
            trigger: manual
            deployment: staging
            script:
              - python deploy.py

    このファイルの構成方法の詳細についての詳細もご確認ください。

  2. 編集内容に満足し、最初の Pipeline を実行する準備が整ったら、[ファイルのコミット] を選択します。

これで、既定のパイプラインが作成できました! 

Pipelines will now automatically trigger whenever you push changes to your repository, running the default pipeline.

パイプラインを最大限に活用できるよう、さらに多くの情報を bitbucket-pipelines.yml ファイルに追加できます。たとえば、ビルドに使用したい Docker イメージを定義したり、特定のブランチタグ、およびブックマークのビルド構成を作成したりできます。




次のステップ

Now that you've got the basics, have a look at how you can view your pipelines.

最終更新日 2018 年 7 月 25 日

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する

このセクションの項目

Powered by Confluence and Scroll Viewport.