プロジェクト

はじめに

私たちは、公開されている gitlab-da グループでプロジェクトを維持しています。このグループは Ultimate サブスクリプションにアクセスできます。

このグループは、ユースケース、デモ環境、ワークショップ、チュートリアル、保守対象のプロジェクト、プレイグラウンドでの研究、その他の学習リソースを整理しています。

組織構成

すべてのプロジェクトは、トップレベルのサブグループに整理されています。トップレベルの名前空間 gitlab.com/gitlab-da にはプロジェクトを置くことはできません。

アクセス

アクセスは gitlab-da グループのチームメンバーに限定されています。メンバーの追加/削除には、変更を文書化するための Issue が必要です。

許可される例外は、外部ユーザーを一時的にワークショッププロジェクトに招待するワークショップのサブグループです。一時的に追加されたすべてのユーザーは、必ず 7 日間のメンバーシップの有効期限を使用する必要があります。

新しいプロジェクトまたはグループを追加する

1. プロジェクトのスコープを定義し、トップレベルグループのいずれかに追加します。
2. 不確かな場合は、まず playgroundグループにプロジェクトを作成し、後でプロジェクト設定で本番の場所に移動します。

Issue/MR で変更を最初に提案することなく、新しいトップレベルグループを作成しないでください。

README

プロジェクト/グループの目的を説明する README.md ファイルを必ず追加し（テキストを Settings > General > Description にコピーして）、すべてのリソース（Issue、ディレクションページ、ブログ記事など）をリンクしてください。GitLab はプロジェクトの README に加えて グループ READMEもサポートしています。

任意ですが推奨： トピックを示すプロジェクト/グループのアバター画像を追加してください。画像を選ぶ際は、Brand のクリエイティブアセットの調達に関するガイダンスを参照してください。ヒント： 画像のサイズを変更できます。

また、.gitignore、AGENTS.md、CI/CD 設定など、その他のベストプラクティスも、適用可能な場合はデフォルトで適用してください。

グループ： デモ環境

長期にわたって維持されるデモ環境です。説明欄に異なるオーディエンスと DRI が記載されています。 必要に応じて、デモのセットアップを説明するハンドブックページや demo.md ファイルを追加し、他のチームメンバーもデモ環境を立ち上げられるよう支援してください。

長期的に使用するデモ環境の一部は、projects、use-cases、tutorials グループにあります。保守されているすべてのデモ環境とその DRI は、コンテンツライブラリに掲載されています。新しいデモ環境をその表に追加してください。

グループ： ユースケース

1. ブログ記事やソートリーダーシップの研究は、通常、ユースケースや特定のトピックを記述しています。既存の use-casesをレビューし、新しいプロジェクトまたはサブグループを追加してください。
2. ユースケースが新規の場合は、新しいサブグループを作成し、説明を追加し、ハンドブックの組織構成を更新してください。あなた自身を DRI としてテーブルに追加してください。

グループ： チュートリアルとワークショップ

チュートリアルは、特定のトピックを学ぶのに役立つコンテンツを提供し、プロジェクトを維持する DRI が割り当てられています。チュートリアルは、ブログ記事やウェビナーなどで参照されます。

どこから始めればよいか不確かな場合は、まず新しいチュートリアルのサブグループを作成し、後でたとえばコンテンツをワークショップに移行するかどうかを決定してください。

グループ： プロジェクト

projectsグループには、本番で使用されるすべてのプロジェクトが含まれています。チームはワークフローと効率のためにその機能に依存しているため、これらはチームのハンドブックで充実したドキュメントを必要とします。私たちはまた、GitLab Pages とカスタムドメインで提供されるマイクロサイトも維持しています。

プロジェクト/グループを削除する

私たちのデモプロジェクトは、ブログ記事やその他の公開コンテンツで参照されています。これらのプロジェクトの非推奨化をユーザーに知らせるために、可能であれば README の注記を含めて、アーカイブすることが推奨されます。

プロジェクトのリソース

一部のプロジェクトは、Kubernetes クラスター、自己管理型 CI/CD Runner、クラウド VM、ドメインなどへのアクセスを必要とします。チームは、GitLab.com SaaS のデモに必要なこれらの外部インフラ依存関係をホストできる Google Cloud または AWS のクラウドリソースにアクセスできます。詳しくはクラウドリソースのハンドブックを参照してください。

ベストプラクティス

1. プロジェクトのセットアップを README ファイル（または Git リポジトリの docs/ 構造）に文書化します。
2. デモケースと競合しない限り、常にセキュリティスキャンをデフォルトで追加します。
3. GitLab アプリには、アカウントからの OAuth セットアップが必要です。誰もがアプリを維持・更新できるよう、グループ共有アカウント（たとえば demo-tanuki）を使用してください。

開発環境

Developer Advocate の開発環境を参照してください。

製品導入のイニシアチブ

Social チームと連携した LinkedIn Live

GitLab は、月次リリースを紹介し、製品アップデートやソートリーダーシップを共有するために、通常は毎月第 4 木曜日に月次の LinkedIn Live 配信を開催しています。各配信には、GitLab のチームメンバーとスペシャルゲストが登場し、AI を活用したソフトウェア開発の最新事情について議論します。これは Developer Advocacyと Social Mediaの両チームによる共同プロジェクトです。

エピソードは通常 30 分間で、4 〜 5 名のパネリストとモデレーターが登場し、あらかじめ決められたトピックや製品アップデートについて議論します。場合によっては、会話は事前に録画されます。

パネリスト向けの情報

配信/録画の前に

• Social Media チームや他のパネリストと一緒に、アジェンダ、段取り、プロモーションについて話し合うための一時的な Slack チャンネルに追加されます。
• 録画/配信の前に、技術チェックを行い、話のポイントを確認し、他のパネリストと顔合わせをするための 30 分のウォークスルーに参加できるよう依頼されます。
• LinkedIn のイベントページに登壇者として追加されるため、あなたが LinkedIn でライブ配信を行うことがあなたのネットワークに通知されます。
• イベントを宣伝する LinkedIn の投稿をあなたのネットワークと共有して、イベントのプロモーションにご協力ください。

配信/録画の最中

• 強い WiFi 信号があり、気が散るもののない、十分に明るい場所にいることを確認してください。
  • 理想的には、バーチャル背景を使用してください。
• GitLab のスワッグを持っている場合は、着用してください！
• マイクとしてヘッドセットを使用してください。

配信の後に

• 配信にコメントした人々とエンゲージしてください。
• イベントの動画をあなたのネットワークと再共有してください。

アーカイブ済みのプロジェクト

コミュニティニュースレター

• ゴール： 開発者向けのコンテンツを共有し、コミュニティメンバーに今後のイベントについて知らせ、コミュニティ内でのコントリビューションを促進する。このニュースレターのターゲットオーディエンスは、私たちのコミュニティにおける GitLab のコントリビューター志望者および既存のコントリビューターです。このニュースレターは、リードの獲得や創出には使用しません。
• 期間： 2022 〜 2024
• 組織エピック
• メンテナー： @sugaroverflow
• アーカイブ：
  • FY23 ニュースレターのエピック
  • その他過去のすべてのニュースレターの Issue は、ラベル Da-Type-Content::newsletterを使用してクローズ済みの Issue を検索することで見つけられます。
  • ニュースレター各号の PDF（内部）

GitLab Duo Coffee Chat

GitLab Duo の助けを借りて、DevSecOps ライフサイクル全体にわたって AI を活用したワークフローを使うライブ学習セッションです。私たちは議論し、探求し、調査し、学び、デバッグし、製品フィードバックや機能のアイデアを生み出し、新しい機能やワークフローを発見します。詳しくは FY25 Developer Relations エピック（内部）をご覧ください。

ゴール： コーヒーチャットは、私たちの顧客が GitLab Duo の使い方を学び、ベストプラクティスを採用できるよう支援します。実例を示し、間違いを犯し、さまざまなルートを試し、より良い結果と DevSecOps の効率を達成することによって行います。

メンテナー： Michael Friedrich, @dnsmichi

• YouTube プレイリスト
• プロジェクトを含む GitLab グループ
• GitLab Duo
• 講演：AI の力を借りた効率的な DevSecOps ワークフロー - コンテンツエピック
• 組織 Issue
• 録画動画の編集用のスライドテンプレートとリソース。

録画は、GitLab Duo Use Cases ドキュメントからもリンクされています。

プロセス

1. セッションのスコープを定義します（たとえば、30 分でアプリケーションを書く、または COBOL のような新しいプログラミング言語を探求する）。Duo Challenges では、IDE または GitLab UI のコンテキストにとどまる必要があります。
2. ゲストを招待してコラボレーションします（任意）
3. Zoom の録画を開始し、セッションのゴールについて短く紹介します。1 人の場合は、OBS を使用してセッションを録画することもできます。
4. セッションを開始し、Duo Chat に始め方を尋ね、Code Suggestions などで続けます。
5. 終了/時間で停止するときは、一息ついて、今日学んだことのまとめを提供します。
6. 動画をエクスポートします。
7. 学びを際立たせるセッション（または IDE）のスクリーンショットを撮ります。スクリーンショットをスライドのプレースホルダーに追加し、セッションの詳細でテキストを編集し、再度スライドのスクリーンショットを作成します。これは Premiere Pro で動画のイントロダクションとして使用します。

Adobe Premiere Pro での動画編集：

1. Adobe Premiere Pro で新しいプロジェクトを作成します。
2. 録画とイントロ/アウトロの画像アセットをインポートします。
3. 動画を新しいシーケンスにドラッグします。
4. 最初の 3 〜 5 秒にイントロのスクリーンショットを追加します。右クリック > フレームサイズに合わせてスケール。
5. レイザーアイコンを使用して、イントロシーケンスの後で動画をカットします。最初の部分を選択してシーケンスを削除します。
6. 最後の 3 〜 5 秒に終了のスクリーンショットを追加します。右クリック > フレームサイズに合わせてスケール。
7. レイザーアイコンを使用して、終了シーケンスの前で動画をカットし、無音部分を削除します。最後の部分を選択してシーケンスを削除します。
8. 生の動画をエクスポートします： File > Export > Media。

動画のアップロード：

1. YouTube の GitLab Unfiltered アカウントにログインし、動画ファイルをアップロードします。
2. セッションのタイトルを編集します： GitLab Duo Coffee Chat: Challenge - Explain and Refactor COBOL programs など。
3. 何が期待できるかを 2 〜 3 文で動画の説明欄に編集します。すべてのドキュメント/ブログ URL を Resources のエントリとして追加します。
4. 新しいウィンドウで動画のプレビューを開き、各セクションをスクロールします。タイムスタンプをメモし、動画の説明欄に目次を書き込みます。目次は視聴者がすばやく移動するのに役立ちます。
5. Playlist - GitLab Duo Coffee Chat に追加します。
6. タグを追加します： gitlab、gitlab-duo、ai、development など。
7. 動画を公開します。

配信

1. 動画を GitLab Use Case ドキュメント、Highspot、ブログ記事、ソーシャル投稿などに追加します。

CI/CD コンポーネントカタログ

GitLab がメンテナンスするコンポーネントの CI/CD テンプレートの移行を通じて、CI/CD コンポーネントカタログのシードを支援するために、製品およびエンジニアリングと協力します。コミュニティのコンペティションやハッカソンからのコントリビューションの保守とレビューを支援します。学んだことをコンテンツやストーリーテリングに再利用します（コンテンツエピック）。詳しくは FY25 Developer Relations エピック（内部）をご覧ください。

このイニシアチブは、CI Adoption WGと Developer Relations によるコントリビューション（エピック）の一部です。

ゴール： DevSecOps の効率のために、CI/CD コンポーネントで顧客を支援する。ベストプラクティスを学び、ブログ記事、チュートリアル、ワークショップで共有します。

メンテナー： Michael Friedrich, @dnsmichi、Itzik Gan Baruch, @iganbaruch

Developer Relations Bot

メンテナー： TBD。当面は Michael Friedrichに尋ねてください。

このボットは、次のようなチームのタスクを自動化することを目的としています。

• チームメンバー向けに リリースエバンジェリズムの Issue を作成する。
• Developer Advocacy ワークフローに従って Issue をトリアージする。
• 毎週月曜日に Issue レター（作成済み、クローズ済み、オープン中の CFP）を生成する。

プロジェクト： DevRel Bot

ページのソースコードを見る - ページの編集 - please contribute.