このページには、Google シーズンのドキュメントで受け入れられているテクニカル ライティング プロジェクトの詳細が記載されています。
プロジェクトの概要
- オープンソースの組織:
- Jenkins プロジェクト
- テクニカル ライター:
- Zaycodes
- プロジェクト名:
- Kubernetes での Jenkins
- プロジェクトの期間:
- 標準の期間（3 か月）
プロジェクトの説明
Kubernetes は Google が開発したプラットフォームに依存しないコンテナ オーケストレーション ツールで、Cloud Native Computing Foundation のプロジェクトとしてオープンソース コミュニティから多大なサポートを受けています。また、コンテナ インスタンスを使用して、スケーリングとフォールト トレラントのために管理することもできます。個別のソリューションやカスタムコードを必要とする幅広い管理アクティビティ（リクエストのルーティング、コンテナの検出、ヘルスチェック、ローリング アップデートなど）にも対応しています。
Kubernetes は CI/CD ツールの大部分と互換性があるため、デベロッパーはダウンタイムなしでテストの実行、Kubernetes でのビルドのデプロイ、アプリケーションの更新を行うことができます。現在最も人気のある CI/CD ツールの一つが Jenkins です。理由は以下のとおりです。 1. これはオープンソースであり、無料です。 2. ユーザー フレンドリーでインストールが簡単で、追加のインストールやコンポーネントを必要としない。 3. Jenkins は構成、変更、拡張も非常に簡単です。 4. コードを瞬時にデプロイし、テストレポートを生成します。 5. Jenkins は、継続的インテグレーションと継続的デリバリーの要件に従って構成できます。6. Jenkins は、OS X、Windows、Linux など、あらゆるプラットフォームとさまざまなオペレーティング システムで利用できます。7. また、充実したプラグイン エコシステムも誇ります。Jenkins には幅広いプラグイン プールがあり、さまざまなプラットフォームでビルド、デプロイ、自動化を行うことができます。 8. インテグレーション作業のほとんどが自動化されている。そのため、統合の問題が少なくなります。これにより、プロジェクトの全期間における時間と費用の両方を節約できます。
Kubernetes 上の Jenkins は以下の理由で Jenkins ユーザーにとって人気のあるテーマとなっていますが、現時点では Kubernetes 上の Jenkins に関するドキュメントを一元管理できる場所がないため、Kubernetes 上の Jenkins では情報の移動や検索が困難になっています。このプロジェクトでは、Jenkins を実行する Kubernetes ユーザー向けにコンセプト、手法、選択肢について説明する Kubernetes ソリューションのページを新たに作成します。
現在のステータス
Kubernetes での Jenkins の実行については多数のプレゼンテーションや記事がありますが、Kubernetes での Jenkins について一元的に説明できる場所がありません。次のようなことが難しくなります。 1. Kubernetes の Jenkins（ユーザーが移動して情報を参照できる） 2. Kubernetes 上の Jenkins に関する情報を追跡、更新、管理する
提案されたドキュメントが現在のドキュメントより改善された理由は何ですか。
Kubernetes 上の Jenkins のドキュメントで既存の問題を解決するために、この構造に従って Jenkins.io に Kubernetes ソリューション ページを作成します。このソリューション ページでは、既存の資料と関連プロジェクトを集約します。このプロジェクトには次の利点があります。
- Kubernetes 上の Jenkins に関する情報をワンストップ ショップで利用できるようにすることで、Kubernetes ユーザーにおける Jenkins のユーザー エクスペリエンスを向上させます。
- [ソリューション] ページを使用して、Kubernetes 上の Jenkins に関する情報を簡単に追跡、更新、保守できるようにします。
デベロッパーとして、問題に直面し、1 つの情報を見つけるまでに何時間もナビゲートしなければならないという障壁に直面する必要があるのは、とても大変です。私がこのプロジェクトに携わることにしたのは、Kubernetes で Jenkins のソリューション ページを作成することで、Jenkins ユーザーのエクスペリエンスを向上させる機会が得られるからです。
分析
私は Kubernetes のソリューション ページの構成を作成し、Kubernetes 上の Jenkins に関する既存の資料の一部と、いくつかの有用なリソースへのリンクを集約しました。また、「本当に優れたユーザー ドキュメントを作成するには、実際にプロダクトを使用している外部のユーザーの話を聞いて、その課題について学び、できる限り対処する必要がある」という事実を踏まえて、Kubernetes ソリューション ページの新しい構造を Interswitch の Kubernetes の Jenkins ユーザーと Jenkins コミュニティと共有し、新しいドキュメントで見つかりたいことについて意見を聞きました。ただし、この構成は、導入を開始する前にメンターが承認し、変更する必要があります。
プロジェクトの目標
Jenkins のソリューション ページで次の構造に従って、新しい Kubernetes ソリューション ページを作成します。または、Jenkins を実行する Kubernetes ユーザーのためのコンセプト、手法、選択肢を説明するボリュームを作成します。