Tech Stack アプリケーション
Tech Stack のプロセスは HelpLab に移行しました
Tech Stack の管理プロセス全体は、10 月 22 日 (水) に正式に HelpLab へ移行しました。
- HelpLab 上の Tech Stack はこちら からアクセスできます。Okta の 「Application Tech Stack」 アプリ経由でも利用可能です。
既存のマージリクエストがありますか?
- 心配は不要です。進捗状況に応じて、変更を完了し、HelpLab 上の Tech Stack に反映します。
新しいマージリクエストを作成する予定ですか?
MR を提出する代わりに、新しい Tech Stack 更新フォーム をご利用ください。
- HelpLab の Tech Stack 更新フォーム を使用してください。
- Okta > HelpLab > IT > Tech Stack Update
定義とアクセス
Tech Stack は、事業を支えるために GitLab が現在使用しているすべてのテクノロジーのリストです。すべての部門で使用されるシステム、アプリケーション、ツール、データに加えて、ビジネス目的/説明、オーナー、プロビジョナー、アクセスチーム、その他の関連属性が記載されています。
HelpLab 上の Tech Stack は現在、すべてのシステム情報および変更の公式な単一情報源 (Single Source of Truth) となっています。次の経路でアクセスできます。
- Okta → HelpLab → IT → Tech Stack Update
- Okta ダッシュボードで 「Application Tech Stack」 アプリを検索する
- 直接リンク: HelpLab 上の Tech Stack
多くのアプリケーションには Tech Stack ガイド があり、各アプリの使われ方や実装方法を理解できます。
Tech Stack の Jupyter Notebook ビュー を使うと、データのフィルタリングや CSV、JSON、Markdown 形式へのエクスポートが可能です。
役割と責任
| 役割 | 責任 |
|---|---|
| システムのビジネスオーナーおよびテクニカルオーナー | Tech Stack データの完全性と正確性に対する説明責任を負う。Tech Stack の更新 を処理する。システム関連の問い合わせと管理の一次窓口となる。 |
| IT Business Technology | Tech Stack の Code Owner。サポートシステムについてビジネスオーナーおよびテクニカルオーナーに助言する。 |
| Security Risk | 新規および既存システムの Tech Stack 更新を支援する。これには ビジネス影響度分析 の実施も含まれる。 |
Tech Stack の定義
- ビジネスオーナー: ツールに関する予算と意思決定のすべてを担う個人 (複数の場合あり)。ツールがどのように、誰によって使われるかを定義します。通常はツールに
Ownerとしてのログインアクセスを持ちますが、すべての場合でログインアクセスが必須というわけではありません。このフィールドには、チームではなく必ず個人の名前を記載してください。 - テクニカルオーナー: システムの性質によっては、ビジネスオーナーと同じ場合があります。たとえば、一元管理されておらず、設定がほとんど必要ないシステムなどです。中央集権的に管理されている、あるいは設定が多いシステムの場合、テクニカルオーナーは、アプリケーションのアーキテクチャや機能 (扱うデータの種類を含む)、GitLab に対する全体的な重要度や影響を理解している人物です。テクニカルオーナーは通常、ツールの
administratorsです。これには、ツールのアクセスをプロビジョニング/デプロビジョニングする管理者権限を持つすべての人、および/またはツールを管理するために必要な技術的専門性を持つ人が含まれます。 - プロビジョナー/デプロビジョナー: ツールへのチームメンバーのアクセスを付与・削除する責任者。ハンドブックに記載されるすべてのツールには、少なくとも 2 名のプロビジョナー/デプロビジョナーを指名する必要があります。プロビジョナーは Slack では
@provisionersハンドルで、GitLab では@tech-stack-provisionerハンドルでグループとして連絡できます。
Tech Stack の更新
Tech Stack のすべての変更は、HelpLab の Tech Stack 更新フォーム を使って提出する必要があります。
Tech Stack 更新リクエストの提出方法
HelpLab → IT → Tech Stack Update にアクセスします。 (Okta 経路: Okta → HelpLab → IT → Tech Stack Update)
HelpLab で IT セクション配下の Tech Stack 更新フォーム を開きます。
フォームが読み込まれたら、「What can we help you with?」 から該当するオプションを選択します。 選択内容に応じて適切なフォローアップ質問が自動的に表示されます。
必要な詳細をすべて入力し、リクエストを送信します。
処理とワークフロー
- すべてのリクエストは HelpLab を介してルーティングされます。
- HelpLab Team / IT EntApps Team がエントリーをレビュー、検証、更新します。
- オーナーシップの役割は変わりません。引き続き、各システムのビジネスオーナー、テクニカルオーナー、プロビジョナーを指定します。
Tech Stack にはどのようなデータが格納されますか?
Tech Stack を更新する際は、以下の手順に従い、各フィールドに正しい種類のデータを入力してください。
| フィールド | データの種類 | 入力内容 | 入力責任者 |
|---|---|---|---|
| title | テキスト | Tech Stack に追加するシステムの名称。ツールに紐づく正式かつ正確なブランド名を入力してください。例: “Zendesk (ZenDesk ではない)” | MR 作成者および貢献者 |
| team_member_baseline_entitlement | ブール値* | ベースラインエンタイトルメントとは、全 GitLab チームメンバーがアクセスできるシステムを指します。例: “Zoom”。Tech Stack のほとんどのシステムはベースラインエンタイトルメントではありません。 | MR 作成者および貢献者 |
| description | テキスト/Markdown | システムのビジネス目的。システムが何のために使われているかについての追加情報を提供できるハンドブックページや Web サイトへのリンクを追加してください。例: “ContractWorks は契約管理ソフトウェアです。このプロセス は、契約や関連するベンダードキュメントを完全締結後にファイリングするために使用します。” | MR 作成者および貢献者 |
| access_to | テキスト | このシステムへのアクセスを必要とする個人またはチームを定義。例: Strategic Marketing および Product Managers | MR 作成者および貢献者 |
| provisioner | シングルクォート付きテキスト、GitLab ユーザー名 | このシステムへのアクセスのプロビジョニング担当者のユーザー名をカンマ区切りで追加。1 つのツールにつき少なくとも 2 名のプロビジョナーを記載する必要があります。例: ‘@username, @username1’ | MR 作成者および貢献者 |
| deprovisioner | シングルクォート付きテキスト、GitLab ユーザー名 | このシステムからのアクセス削除担当者のユーザー名をカンマ区切りで追加。1 つのツールにつき少なくとも 2 名のデプロビジョナーを記載する必要があります。チームメンバーはプロビジョナーとデプロビジョナーを兼任できます。例: ‘@username, @username1’ | MR 作成者および貢献者 |
| group_owner | テキスト | ツールのグループオーナー (チーム/部門/機能) を追加。例: Infrastructure | MR 作成者および貢献者 |
| group_owner_slack_channel | テキスト | グループオーナーへ支援を依頼できる Slack チャンネルを追加。例: #infrastructure_platforms | MR 作成者および貢献者 |
| business_owner | テキスト | ビジネスオーナーは、ツールに関する予算と意思決定のすべてを担う個人 (複数の場合あり) です。ツールがどのように、誰によって使われるかを定義します。通常はツールに Owner としてのログインアクセスを持ちますが、すべての場合でログインアクセスが必須というわけではありません。このフィールドには、チームではなく必ず個人の名前を記載してください。例: Jane Doe, John Doe | MR 作成者および貢献者 |
| technical_owner | テキスト | テクニカルオーナーは、ツールのすべての administrators です。これには、ツールのアクセスをプロビジョニング/デプロビジョニングする管理者権限を持つすべての人、および/またはツールを管理するために必要な技術的専門性を持つ人が含まれます。例: Jane Doe, John Doe。システムに管理者機能を必要としない/有さないケースについては、上記のガイダンス を参照してください。 | MR 作成者および貢献者 |
| data_classification | テキスト (Red, Orange, Yellow, Green) または Unknown** | Security チームによって決定されます。このプロセスが完了するまでは null のままにしておいてください。データ分類標準 について詳細を確認できます。 | Security Risk |
| authentication_method | テキスト (Okta SWA, Okta SAML, ID とパスワード, その他) または Unknown** | システムにアクセスするための認証方式。SWA、SAML、または直接アクセス (メールとパスワードのログイン) などその他の方式があります。 | MR 作成者および貢献者 |
| critical_systems_tier | テキスト (Tier 1 Mission Critical, Tier 2 Business Critical, Tier 3 Business Operational, Tier 4 Administrative, TBD) または Unknown** | このフィールドは、GitLab の 重要システム階層定義 に基づいてシステムを分類します。重要システム階層の割り当ては、ビジネス影響度分析 (BIA) アンケートの完了に依存します。Security Risk Team は、システムを Tech Stack に追加する時点で BIA がまだ完了していない場合、BIA の完了を調整します。 | Security Risk |
| collected_data | テキスト または Unknown** | ツールによって収集されるデータ | MR 作成者および貢献者 |
| employee_or_customer_facing_app | テキスト (employee, customer) | アクセスが GitLab チームメンバーに限定される場合は employee を追加してください。アクセスが外部関係者にも付与可能な場合は customer を追加してください。 | MR 作成者および貢献者 |
| notes | テキスト または Unknown** | 他のフィールドで捕捉されないシステムに関する追加の関連情報。例: 実装とロールアウト用の GitLab Epic など。 | 任意, MR 作成者および貢献者 |
| handbook_link | テキスト/Markdown または Unknown** | 機能とシステム情報を含む Tech Stack Guide ハンドブックページへのリンク。例: “Marketing ハンドブックには Marketo Tech Stack ガイド が掲載されています。” | 任意, MR 作成者および貢献者 |
| external_link | テキスト/Markdown または Unknown** | アプリの公式 Web サイトへのリンク。例: “ContractWorks” | 任意, MR 作成者および貢献者 |
| google_group | テキスト または Unknown** | Okta 経由でシステムへのアクセスを管理するために使用される Google グループ | 任意, MR 作成者および貢献者 |
| accessibility | ブール値 | アプリケーションはアクセシビリティ機能をサポートしていますか? Yes または No を選択してください。(既存アプリケーションには一時的に “TBD” が設定されています) | MR 作成者および貢献者 |
| accessibility_description | テキスト | アクセシビリティ機能を有効化する、または有効化リクエストを送信する手順を記載します。(ハンドブックページやリクエスト入口へのリンクを含めることもできます) | MR 作成者および貢献者 |
| now_id | テキスト/ServiceNow ID | ServiceNow 用の連携 ID。EntApps エンジニアが入力するので空欄にしてください。 | 貢献者, ServiceNow エンジニア |
- *ブール値の場合、
trueまたはfalseのいずれかを明示的に入力する必要があります。 - **Unknown: 情報が不明な場合は、フィールドを空欄にせず、代わりに
nullと入力してください。
Tech Stack への新規システムの追加
新規システムを Tech Stack に追加するプロセスは、完全に HelpLab へ移行しました。tech_stack.yml ファイルへのマージリクエスト作成ではなく、以下のプロセスに従ってください。
HelpLab → IT → Tech Stack 更新 にアクセスします。 (Okta 経路: Okta → HelpLab → IT → Tech Stack Update)
フォームを開き、Add a New System を選択します。 システムの説明、オーナーシップ、プロビジョナー、アクセスの詳細、データ分類、その他の関連属性など、必要なフィールドがすべて自動的に表示されます。
詳細を入力し、リクエストを送信します。
注意: Legal、IT Compliance、Internal Audit、Security Risk、Business Systems の各チームがワークフローに自動的に組み込まれ、リクエストが確定する前にそれぞれの担当セクションを完了します。
Tech Stack 内の既存システムの更新
すべてのシステム更新は HelpLab を通じて行う必要があります。tech_stack.yml ファイルへのマージリクエスト作成ではなく、以下のプロセスに従ってください。
- HelpLab → IT → Tech Stack 更新 に移動し、Update an Existing System を選択します。
- 修正したいシステムを選択します。
- 更新の種類に応じたフォローアップ質問がフォームに自動的に表示されます。
- 必要な変更を入力し、フォームを送信します。
該当するレビューグループが HelpLab ワークフローの一部として更新を検証・処理します。
Tech Stack からのシステムの削除
Tech Stack からシステムを削除するには、tech_stack.yml ファイルへのマージリクエスト提出ではなく、Tech Stack 更新 フォームを使用してください。
- HelpLab → IT → Tech Stack 更新 にアクセスし、Remove a System を選択します。
- 廃止やオフボーディングの背景情報と、プロセスを開始するために必要な詳細を提供します。
- このワークフローの一部として、ビジネスオーナー は Legal および IT Compliance と連携し、データ削除および契約上の要件が完全に満たされていることを保証する必要があります。
- すべてのステップが完了し検証されると、HelpLab Team / EntApps Team がシステムを Tech Stack から削除します。
時折、Tech Stack に掲載されているシステムが廃止されることがあります。システムがオフボーディングされる場合 (使用されなくなる、または置き換えられる)、HelpLab の Tech Stack 更新 ワークフローを通じて Remove a System リクエストを提出してください。
このプロセスの一環として、ビジネスオーナーは Legal および IT Compliance と協力し、ベンダー契約に従ってデータ削除と契約上の要件がすべて完了することを保証する必要があります。すべてのステップが検証されると、システムは HelpLab ワークフローを通じて Tech Stack から削除されます。
その他の関連プロセス
アクセスリクエスト
システムへのアクセスをリクエストする方法の詳細は、アクセスリクエストハンドブックページ を参照してください。ユースケースに合った正しいテンプレートを選択し、手順に従ってください。
調達
新しいアプリケーション/システムを調達したい場合は、調達ハンドブックページ を参照して開始方法の詳細を確認してください。このプロセスを経たアプリケーションのみが Tech Stack に追加できます。
サポート
アプリケーション/システムに問題が発生していますか? Tech Stack YAML で Group Owner/Slack Channel を確認すれば、サポートを依頼すべき Slack チャンネルが分かります。
コンプライアンス
Tech Stack に掲載されている多くのアプリケーションは、規制対応やその他のコンプライアンス活動の対象となっています。詳細は以下の DRI までお問い合わせください。
- FedRAMP: Corey Oas (@corey-oas), Security Compliance
- GitLab SaaS SOC2: Liz Coleman (@lcoleman), Security Compliance
- GitLab Dedicated SOC2: Corey Oas (@corey-oas), Security Compliance
- ISO 27001: Liz Coleman (@lcoleman), Security Compliance
- SOX: Sean Brown (@sbrown10), Internal Audit
オフボーディングテンプレートの更新
新しいシステムが Tech Stack に追加されると、GitLab がコンプライアンスを保ち、退職後のチームメンバーをシステムから削除するために、オフボーディングテンプレートを更新する必要があります。オフボーディングテンプレートを更新する方法は 2 種類あります。新しいシステムの使用状況に最も適したオプションを選んでください。MR がマージ可能な状態になったら、People Operations チーム (@gl-people-ops-team) にタグ付けして承認とマージを依頼します。
オプション 1: 複数部門にわたる多数のチームメンバーが使用する新規システム
メインのチームメンバーオフボーディング テンプレートを更新します。
メインテンプレートは 2 つのセクションに分かれています。最初のセクションは Offboarding Tasks セクションです。このセクションはすべての GitLab チームメンバーに適用され、マネージャー、People、Business Technology、Finance/Accounting の各チームによって実行されます。
2 つ目のセクションは Tech Stack System Deprovisioning / Offboarding セクションです。このセクションを、Tech Stack に追加される新規システムで更新します。以下のフォーマットを使用して更新してください。
## Department that owns the new system. If new system is owned by multiple departments, list the department the main deprovisioner belongs to. Please make sure the department does not already exist within the template. If it does, ignore this header and just add the following information underneath the existing department header
#### <summary>Name of deprovisioner @usernameofdeprovisioner, Name of deprovisioner 2 @usernameofdeprovisioner2, etc. </summary>
<table >
<tbody>
<tr>
<td> `System name` </td>
<td>
- [ ] Access Deprovisioned - System name
- [ ] Not Applicable to Team Member - System name
</td>
</tr>
</tbody>
</table>
完了したら、‘Tech Stack - Add New System’ MR の “Access Tasks” セクションに当該 MR をリンクしてください。
オプション 2: 同一部門内の限定された人数のチームメンバーが使用する新規システム
このディレクトリ内の 部門レベルのオフボーディングテンプレート を更新します。
上記のリンクを使用して、新規システムを所有する部門のテンプレートを見つけ、更新します。例: Security チームのみが新規システムにアクセスする場合、Security テンプレート を見つけて、以下のフォーマットに従って新規システムを追加します。
- [ ] @usernameofdeprovisioner @usernameofdeprovisioner2: Remove the team member from System name
完了したら、‘Tech Stack - Add New System’ MR の “Access Tasks” セクションに当該 MR をリンクしてください。
例外
Tech Stack へのテクノロジー追加には例外があり、それらはケースバイケースで処理されます。
a1f3c26a)