概要

Testing with Google Cloud Test Labの意訳。

Google Cloud Test Labでのテスト

このガイドは現在β版で提供されいているGoogle Cloud Test Labのコマンドを元に作成しています。公式ドキュメントのOverviewを常に確認するようにしてください。

事前準備

CircleCIでCloud Test Labを使用する前に、以下のステップを完了させる必要があります。

1. gcloudのセットアップ

Using Cloud Test Lab from the Command Lineを参考にGoogle Cloudのプロジェクトを作成し、Cloud Test LabのBetaプログラムへの参加を申請します。そしてローカルにGoogle Cloud SDK環境を構築しましょう。CircleCIにはGoogle Cloud SDKの利用環境がデフォルトで用意されいていますが、コマンドの挙動を確認したりする際にローカルにも環境が構築してあると役立ちます。

2. サービスアカウントの作成

サービスアカウントを作成します。サービスアカウントを利用することで、gcloudは人間の代わりにプログラムをユーザーとして扱います。これによって、スパムチェックを回避し、ブロックまたはcaptchaを要求されることからアカウントを防ぐことができます。gcloud auth activate-service-account commandを参考にサービスアカウントの作成と有効化を行ってください。

3. 必要なAPIの有効化

サービスアカウントでログイン後、Google Developers ConsoleでGoogle Cloud Testing APIとCloud Tool Results APIを有効化します。これらのAPIを有効にするためには、コンソール上部の検索窓にAPI名を入力し、APIの概要ページで「APIを有効にする」をクリックします。

CircleCIのセットアップ

もしあなたがCircleCIのユーザーで無いのならば、Getting Started guideを参考にすることでセットアップをすぐに完了できます。

また、このセクションでは、説明のためのサンプルとしてNotepad example Android appを使用します。

プロジェクトの設定と環境変数

以前のセクションでサービスアカウントを作成した際に拡張子が.jsonとなっているprivate keyがダウンロードされたと思います。CircleCIがgcloudを認証するために、CircleCIはこのkeyへアクセスする必要があります。しかし、keyをバージョンコントロール下で直接管理するのはセキュリティ的にスマートなやり方ではありません。

keyを直接管理する代わりにCircleCIの環境変数を利用して認証させましょう。どうすればいいかはこちらを参照してください。

circle.yml

dependencies:
  pre:
    - sudo pip install -U crcmod
  post:
    - ./gradlew :app:assembleDebug -PdisablePreDex
    - ./gradlew :app:assembleDebugTest -PdisablePreDex
    - echo $CLIENT_SECRET | base64 --decode > ${HOME}/client-secret.json
    - sudo /opt/google-cloud-sdk/bin/gcloud config set project circle-ctl-test
    - sudo /opt/google-cloud-sdk/bin/gcloud --quiet components update
    - sudo /opt/google-cloud-sdk/bin/gcloud --quiet components install beta
    - sudo /opt/google-cloud-sdk/bin/gcloud auth activate-service-account --key-file ${HOME}/client-secret.json

まずcrcmodのインストールから始めます。これは、Googleのgsutilツールを利用するために必要になります。

dependenciesセクションでは、debug apkとtest apkの両方をビルドしています。そして、その次にgcloudのセットアップを行っています。ここでは、.json keyを再生成し、プロジェクトの指定やCloud Test Labを利用するためのbetaコマンドのインストール、そして再生成したkeyを使用してgcloudへの認証を行います。上記サンプルのプロジェクト名は適宜置き換えてください。

test:
  override:
    - echo "y" | sudo /opt/google-cloud-sdk/bin/gcloud beta test android run --app app/build/outputs/apk/app-debug.apk --test app/build/outputs/apk/app-debug-test-unaligned.apk --results-bucket cloud-test-circle-ctl-test
  post:
    - sudo /opt/google-cloud-sdk/bin/gsutil -m cp -r -U `sudo /opt/google-cloud-sdk/bin/gsutil ls gs://cloud-test-circle-ctl-test | tail -1` $CIRCLE_ARTIFACTS/ | true

testセクションでは、CircleCIのgradle testのデフォルトのアクションを上書きし、その代わりにgcloudにCloud Test Labでのテストの実行を指示します。apkネームやGoogle Cloud StorageのURLについては、適切なものに置き換えてください。

postはtestセクションにおいてデフォルトアクションやpre、overrideより後に実行されます。ここでgsutilを使うことでCircleCIのartifactsにbucketのもっとも新しいファイルをダウンロードすることができます。これによって、Google Cloud StorageとCircleCIの両方でテスト結果を利用することができます。