すべてのBitriseユーザーとステップを共有する

あなたのステップが他の人に役立つと思うなら、あなたはそれを共有することができます!ただし、その前に、同じ問題を解決する他の手順がないことを確認してください。確認してもいい:

特定の機能が不足しているステップを見つけた場合は、その機能の新しいステップを開発または共有する前に、そのステップに貢献してみてください。あなたは私たちを使用することができます 統合ページ BitriseStepLibでステップを検索します。特定のステップのページでGitHubソースボタンをクリックすると、ステップのリポジトリに移動します。ここで、機能リクエストを送信したり、プルリクエストを開いたりできます。

また、共有ステップは積極的に維持され、貢献者に開かれている必要があることに注意してください。

新しいステップを共有する

共有プロセスは比較的簡単ですが、新しいステップを共有するときは、プロセスを慎重に実行するようにしてください。

bitriseshareコマンド

ステップ開発中は、bitriseshareを実行するだけでいつでもヘルプを得ることができます。これにより、共有に関する短いガイドが印刷されます。

ステップを共有する方法は2つあります。

  • を使用して手動で行うことができます bitrise share 指図。

  • ステッププラグインを使用してステップを作成した場合は、 share-this-step ステップのディレクトリ内のワークフロー。

始める前に

開始する前に、次のことを確認してください。

  • ステップは公開Gitリポジトリにあります。

  • step.ymlファイルには、有効な課題追跡システムを指すsupport_urlプロパティが含まれています(たとえば、 問題 ステップのGitHubリポジトリのページ)。

  • step.ymlファイルには、リポジトリの正しいGitURLを指すsource_code_urlプロパティが含まれています。

複数のステップを共有する

複数のステップを共有する(つまり、Bitrise StepLibに複数の新しいstep.ymlファイルを追加する)ことは、別々のプルリクエストで行う必要があります!複数の新しいステップを含むプルリクエストを開くことはできません。

準備ができたら、好みの共有プロセスに進んでください。

bitriseshareコマンドとの共有

  1. フォーク Bitrise StepLib リポジトリ。

  2. フォークしたStepLibをローカルで共有できるように準備します。

    $ bitrise share start -c <https://github.com/[your-username]/bitrise-steplib.git>
  3. ステップのリポジトリにステップバージョンタグを追加します。

  4. フォークされたStepLibリポジトリにステップを追加します。

    $ bitrise share create --tag [step-version-tag] --git [step-git-uri].git --stepid [step-id]
  5. 必要に応じて、フォークされたStepLibで完全なヘルスチェックを実行します。

      $ bitrise share audit -c <https://github.com/[your-username]/bitrise-steplib.git>
  6. ステップのstep.ymlファイルを確認し、問題がなければ共有プロセスを終了します。これにより、step.ymlファイルがコミットされてフォークされたStepLibリポジトリにプッシュされます。

      $ bitrise share finish

    これにより、step.ymlファイルがコミットされてフォークされたStepLibリポジトリにプッシュされます。

  7. 公式でプルリクエストを開きます Bitrise StepLib リポジトリ。

このステップを共有するワークフローとの共有

share-this-stepワークフローは、新しいステップを作成するときにStepプラグインが自動的に生成するbitrise.ymlファイルに含まれています。それを使用すると、ステップの共有は非常に簡単です。

  1. フォーク Bitrise StepLib リポジトリ。

  2. 必要なワークフロー環境変数をbitrise.ymlファイルのアプリレベルの環境変数として設定します。

     app: envs: - BITRISE_STEP_ID: - BITRISE_STEP_VERSION: - BITRISE_STEP_GIT_CLONE_URL: - MY_STEPLIB_REPO_FORK_GIT_URL:
  3. BitriseCLIでshare-this-stepワークフローを実行します。

     $ bitrise run share-this-step

StepLibプルリクエストの問題の修正

ステップバージョンをStepLibに送信したら、Bitriseチームがレビューするのを待ちます。変更を求める場合:

  1. プルリクエストを閉じます。

  2. BitriseStepLibのフォークから共有ブランチを削除します。

  3. ステップリポジトリの問題を修正します。

  4. ステップリポジトリの修正を含むコミットに新しいバージョンタグを追加します。

  5. を実行します 共有プロセス また。

問題を修正した後、プルリクエストをマージして、ステップを公開できるようになることを願っています。

放棄されたステップ

あなたがステップメンテナである場合、誰かがあなたのステップに問題またはプルリクエストを提出した場合、あなたは合理的な時間枠内に到達可能であるはずです。ステップの重要な修正/更新について何度か連絡を試み、数週間回答を拒否した場合、コレクション内のステップを非推奨、削除、または置き換える場合があります。放棄されたステップは、それを使用する人にとって脅威となる可能性があります。ステップを他の人と共有する場合は、このことに注意してください。

Bitrise StepLibにあるstep.ymlに含まれているリポジトリと課題追跡システムへの永続的なリンクがあるため、リポジトリと課題追跡システムを削除しないでください。それらが削除された場合、共有プロセス中にBitriseマネージドファイルホスティングサービスでも共有されるため、すでに共有されているステップバージョンは引き続き機能します。ステップの新しいバージョンがリリースされる可能性があり、Bitriseによって管理されます。

ステップを共有したが、それを維持することができなくなった、または維持する意思がなくなった場合は、このリポジトリにGitHubの問題を作成してください。 Bitrise StepLib

ステップの問題の報告

重大な(セキュリティまたは機能)問題があるステップのユーザーの場合は、ステップの問題追跡システムでチケットを作成してください。すべてのステップで、問題を報告するための好ましい方法を宣言します。 support_url 属性。

ステップのメンテナから長期間(数週間以上)応答がない場合は、このリポジトリにGitHubの問題を作成してください。 https://github.com/bitrise-io/bitrise-steplib 放棄されたステップのポリシーに従って、問題の解決を試みます。このコレクションに貢献するすべての人が、あなたが使用するためのステップを提供することによってあなたを助けるためにそうすることを心に留めておいてください!