プロジェクト

はじめに

私たちはプロジェクトをパブリックな 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 のクリエイティブアセットの調達ガイダンスを参照してください。

ヒント: 次の CLI コマンドで画像をリサイズできます:

find . -type f -exec sh -c 'convert {} -resize 150 {}' \;

グループ: ユースケース

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

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

1. チュートリアルは、特定のトピックを学ぶための役立つコンテンツを提供し、プロジェクトをメンテナンスする DRI が割り当てられています。チュートリアルはブログ記事、ウェビナーなどから参照されます。
2. ワークショップは、演習や解答などの形で、単一のリポジトリ内で自己完結型の学習リソースを提供します。

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

グループ: プロジェクト

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

プロジェクト/グループの削除

私たちのデモプロジェクトは、ブログ記事やその他のパブリックコンテンツから参照されています。プロジェクトをアーカイブ/削除する代わりに、これらのプロジェクト/グループを unmaintained に移動して、ユーザーに非推奨であることを示すことを推奨します。

プロジェクトリソース

一部のプロジェクトは、Kubernetes クラスタ、セルフマネージド CI/CD ランナー、クラウド VM、ドメインなどへのアクセスが必要です。チームは、GitLab.com SaaS デモ用にこれらの種類の外部インフラ依存関係をホストできる Google Cloud または AWS のクラウドリソースへのアクセス権を持っています。

詳細はデベロッパーリレーションズ向けクラウドリソースのハンドブックで学べます。

ベストプラクティス

1. プロジェクトのセットアップを README ファイル (または Git リポジトリの docs/ 構造) に文書化します。
2. デモケースと競合しない限り、デフォルトとして必ずセキュリティスキャンを追加します。
3. GitLab アプリにはアカウントからの OAuth セットアップが必要です。本番アプリ (Code challenge など) には、グループ共有アカウント (たとえば DevRel Bot) を使用します。

開発環境

デベロッパーアドボケイト向けの開発環境を参照してください。

製品採用イニシアチブ

GitLab Duo の採用

FY25 デベロッパーリレーションズエピック (内部)。

GitLab Duo コーヒーチャット

DevSecOps ライフサイクル全体で、GitLab Duo の助けを借りて AI を活用したワークフローのライブ学習セッション。私たちは議論し、探索し、調査し、学び、デバッグし、製品フィードバックや機能アイデアを作成し、新機能やワークフローを発見します。

目標: コーヒーチャットは、お客様が GitLab Duo の使い方を学び、ベストプラクティスを採用するのを助けます — 例によって、ミスをし、さまざまなルートを試し、より良い結果と DevSecOps の効率性を達成します。

メンテナ: Michael Friedrich, @dnsmichi

• YouTube プレイリスト
• プロジェクト付き GitLab グループ
• GitLab Duo
• トーク: Efficient DevSecOps Workflows with a little help from AI - コンテンツエピック
• 組織化 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. 新しいウィンドウでビデオプレビューを開き、セクションをスクロールします。タイムスタンプを記録し、ビデオの説明に TOC を書き込みます。目次は視聴者が素早くナビゲートするのに役立ちます。
5. Playlist - GitLab Duo Coffee Chat に追加します。
6. タグを追加します: gitlab、gitlab-duo、ai、development など。
7. ビデオを公開します。

配信

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

CI/CD の採用

FY25 デベロッパーリレーションズエピック (内部)

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

製品とエンジニアリングと協力して、GitLab がメンテナンスするコンポーネント用の CI/CD テンプレート移行を通じて CI/CD コンポーネントカタログをシードする支援を行います。コミュニティのコンペティションやハッカソンからの貢献のメンテナンスとレビューを支援します。学んだことをコンテンツやストーリーテリングに転用します (コンテンツエピック)。

このイニシアチブは CI Adoption WG の一部であり、デベロッパーリレーションズによる貢献です (エピック)。

目標: お客様が DevSecOps 効率化のための CI/CD コンポーネントを使用できるよう支援します。ベストプラクティスを学び、ブログ記事、チュートリアル、ワークショップで共有します。

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

Social チームとのコラボレーションによる LinkedIn ライブ

GitLab は、月次リリースをハイライトし、製品アップデートとソートリーダーシップを共有するために、通常毎月第 4 木曜日に月次 LinkedIn ライブブロードキャストをホストしています。各ブロードキャストでは、GitLab チームメンバーとスペシャルゲストが参加し、AI を活用したソフトウェア開発の最新情報について議論します。これは Developer Advocacy と Social Media チームの間のコラボレーションプロジェクトです。

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

パネリスト向け情報

ブロードキャスト/録画前

• ソーシャルメディアチームと他のパネリストと一緒に、アジェンダ、ロジスティクス、プロモーションについて議論する一時的な Slack チャンネルに追加されます。
• 録画/ブロードキャストの前の 30 分のウォークスルーで、技術チェック、トーキングポイントのウォークスルー、他のパネリストとの面会のために空いていることを求められます。
• LinkedIn のイベントページにスピーカーとして追加されるので、あなたのネットワークが LinkedIn で生中継に出演することを通知されます。
• イベントを宣伝する LinkedIn の投稿をあなたのネットワークと共有して、イベントの宣伝にご協力ください。

ブロードキャスト/録画中

• Wi-Fi の信号が強く、邪魔のない明るい場所にいることを確認してください。
  • 理想的には、バーチャル背景を使用します。
• GitLab のグッズがあれば、着用してください！
• マイクとしてヘッドセットを使用してください。

ブロードキャスト後

• ブロードキャストにコメントした人と交流してください。
• イベントビデオをあなたのネットワークと再共有してください。

アーカイブされたプロジェクト

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

• 目標: 開発者向けコンテンツの共有、コミュニティメンバーへの今後のイベントの情報提供、コミュニティ内での貢献の促進。このニュースレターのターゲットオーディエンスは、私たちのコミュニティの志望および既存の GitLab 貢献者です。このニュースレターは、リードを推進または生成するために使用されません。
• 期間: 2022-2024
• 組織エピック
• メンテナ: @sugaroverflow
• アーカイブ:
  • FY23 ニュースレターエピック。
  • その他の過去のニュースレター Issue は、ラベル Da-Type-Content::newsletterを使用してクローズ済み Issue を検索することで見つけることができます。
  • ニュースレター Issue PDF (内部)

学習コレクション

私たちの作業環境

• この記事で取り上げられている Michael の dotfiles

log4j-resources

log4j-resources プロジェクトは、log4j 脆弱性 (より正式には CVE-2021-44228 として知られている) について学び、検出し、影響を軽減するためのリソースのコレクションを提供します。

メンテナ: デベロッパーアドボカシーチーム

ワークショップ

DevOps と GitLab

DevOps with GitLab CI Course - Build Pipelines and Deploy to AWS

公開: 2022 年。

GitLab Hero Valentin Despa は、Michael Friedrich とのコラボレーションで 5 時間のコースを作成しました。Michael はコースアウトラインのレビューを支援しました。

Efficient DevSecOps Pipelines in a Cloud Native World

公開: 2021 年。

スライドは、Michael Friedrich が Open Source Automation Days 2021 のために作成した 10 時間以上のワークショップを提供しています。スライド内の演習は、解答も含むワークショッププロジェクトを参照しています。

次のトピックが実践されます:

• イントロダクション: CI/CD と Dev、Sec、Ops の出会い
• CI/CD: 用語と最初のステップ
• 分析と特定
  • ワークショップ全体を通して演習プロジェクトをモニタリングするために GitLab CI Pipeline Exporter を学習します。
• 効率化アクション
  • 設定の効率化: 変数内の CI/CD 変数、ジョブテンプレート (YAML アンカー、extends)、includes (local、remote)、ルールと条件 (if、動的変数、条件付き includes)、!reference タグ (script、rules)、独自の CI/CD テンプレートの維持 (テンプレートの include、設定値のオーバーライド)、parent-child パイプライン、マルチプロジェクトパイプライン、失敗を素早く修正するためのより良いエラーメッセージ
  • リソース使用効率: 特定、最大パイプライン継続時間の分析、stage グループ化による高速失敗、async needs による高速失敗、ブロッキングステージパイプラインの分析 (needs を使った解決策)、並列実行のための matrix ビルド (実践: matrix と extends の組み合わせ、matrix と !reference の組み合わせ)、extends のマージ戦略 (!reference ありとなし)
  • CI/CD インフラ効率: 最適化アイデア、カスタムビルドイメージ、C++ を例とするビルド最適化、GitLab Runner リソース分析 (共有、タグ、外部依存関係、Kubernetes)、ローカルランナー演習、リソースグループ、ストレージ使用量分析、キャッシング (Python 依存関係演習、失敗ジョブでの when:always を含む)
  • オートスケーリング: 概要、Terraform を使用した GitLab Runner での AWS オートスケーリング、AWS Graviton 上の Spot Runners に関するインサイト
• グループディスカッション
  • デプロイメント戦略: IaC、GitOps、Terraform、Kubernetes、レジストリ
  • セキュリティ: CI/CD 変数のシークレット、Hashicorp Vault、シークレットスキャン、脆弱性スキャン
  • Observability: CI/CD Runner モニタリング、SLO、品質ゲート、CI/CD トレーシング
  • その他の効率化アイデア: Auto DevOps、Fast vs Resources、結論とヒント

テンプレート: Go Tanuki を使った基本と CI/CD

スライドは、GitLab CI/CD Go Tanuki ワークショップ用の演習としてステップバイステップの手順を提供します:

• GitLab の最初のステップ
• CI/CD: はじめに
• CI/CD: Go プロジェクトとテスト
• GitLab を使ったセキュリティ
• 配信とデプロイ
• 次は何
• 非同期練習用の演習
• 効率性の練習

最近の録画

公開: 2021 年。

過去のワークショップやデベロッパーアドボカシーチームのその他のビデオの録画は、GitLab Unfiltered のチームプレイリストで見つけることができます。

過去のミートアップワークショップ

ミートアップワークショップは、GitLab デベロッパーアドボカシーグループのワークショップグループで利用できます。コンテンツ、演習、ソースコードは時間とともに進化していることに注意してください :)

基本と CI/CD

• TalentQL Pipeline workshop in October 2021
• 1. Swiss Meetup 2021 January
• Morehouse College CI CD Lecture
• CI Community Day 2020
• KDE Akademy Workshop 2020
• LA / SoCal / Orange County Meetup 2020
• Collision from Home GitLab CI workshop
• Linuxing London Meetup - GitLab Introduction
• First virtual GitLab meetup - intro to CI

ドイツ語:

• German CI/CD Workshop 2021

モニタリングとセキュリティ

• Identify, analyze, action! Deep monitoring with CI
• GitLab CI Security Webcast

Developer Relations Bot

メンテナ: TBD。それまでは Michael Friedrich に問い合わせてください。

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

• チームメンバー向けのリリースエバンジェリズム Issue を作成。
• デベロッパーアドボカシーワークフローに従って Issue をトリアージ。
• 毎週月曜日に Issue レター (作成済み、クローズ済み、オープン CFP) を生成。

プロジェクト: DevRel Bot

YouTube2Sheets

メンテナ: TBD。それまでは Michael Friedrich に問い合わせてください。

このプロジェクトは、YouTube 上の指定されたプレイリストからビデオのリストを取得し、指定された Google Sheet に取り込むために GitLab 内部で使用されています。パイプラインは UTC の深夜と正午に実行されるようスケジュールされています。

プロジェクト: YouTube2Sheets

CodeChallenge.dev

メンテナ: 現在は積極的にメンテナンスされていません。

CodeChallenge.dev は、GitLab のアクションに紐づくチャレンジを作成するために使用できるアプリです。たとえば、人々にマージリクエストの作成方法、Issue の追加方法、その他の GitLab 機能の使用方法を教えるチャレンジを作成できます。現在ベータリリース中で、Code Challenge ソフトウェアは KubeCon EU 2022 で初めて使用されました。

ホームページ: CodeChallenge.dev

ドキュメント: docs.codechallenge.dev

プロジェクト: codechallenge

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