rabbit-slide-kenhys-osc2022-online-spring-fluentd 2022.03.12.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: b6ee954ae639a8d8edf7d3056e157d24da2ab415340fc43accd163ae13d75a88
+  data.tar.gz: 7d9a63fc7b2838b82766ab385c0a9a0b9871b86413062e19d168ba472730a489
+SHA512:
+  metadata.gz: c71c0631e2e1da74ccfbdbe91881d5c77f29bfdfc5adb6fb088070b36509826c593eb33e06d7478099c9d1ca121e5686528a05311e9939a018313636d7e794ff
+  data.tar.gz: 9db4e6c8b6f170179d0576a2ff24f72963acc27b4d628d9c5d5cc51e26f3cc3fdee68d2ee77bb0cd8086553089b0d0eee33cf02c847efec1c120b697665858a6

data/.rabbit

@@ -0,0 +1 @@
+--size=1024,768 fluentd.md

data/README.md

@@ -0,0 +1,16 @@
+# OSC 2022 Online Spring Fluentd
+
+This is private repository.
+
+## How to show
+
+  % rabbit
+
+## How to install
+
+  % gem install rabbit-slide-kenhys-osc2022-online-spring-fluentd
+
+## How to create PDF
+
+  % rake pdf
+

data/Rakefile

@@ -0,0 +1,17 @@
+require "rabbit/task/slide"
+
+# Edit ./config.yaml to customize meta data
+
+spec = nil
+Rabbit::Task::Slide.new do |task|
+  spec = task.spec
+  # spec.files += Dir.glob("doc/**/*.*")
+  # spec.files -= Dir.glob("private/**/*.*")
+  # spec.add_runtime_dependency("rabbit-theme-YOUR-THEME")
+end
+
+desc "Tag #{spec.version}"
+task :tag do
+  sh("git", "tag", "-a", spec.version.to_s, "-m", "Publish #{spec.version}")
+  sh("git", "push", "--tags")
+end

data/config.yaml

@@ -0,0 +1,25 @@
+---
+id: osc2022-online-spring-fluentd
+base_name: fluentd
+tags:
+- rabbit
+- fluentd
+- osc2022
+presentation_date: 2022-03-12
+presentation_start_time:
+presentation_end_time:
+slideshare_id:
+version: 2022.03.12.1
+licenses:
+- CC-BY-SA-4.0
+slideshare_id: kenhys
+speaker_deck_id:
+vimeo_id:
+youtube_id:
+author:
+  markup_language: :md
+  name: Kentaro Hayashi
+  email: kenhys@gmail.com
+  rubygems_user: kenhys
+  slideshare_user:
+  speaker_deck_user:

data/development.md

@@ -0,0 +1,99 @@
+# OSC 2022 Spring出展MTG
+
+## 目的
+
+OSC 2022 Spring出展をすすめるにあたって必要なことを決める。
+
+* セッション情報の更新
+  * https://event.ospn.jp/osc2022-online-spring/session/529902 セッションページの更新
+    * あしえさんの講師画像もらっておく
+* zoomリハーサルの希望回答相談
+* 告知の準備について
+* 発表ネタのすりあわせ(これがメイン)
+
+# セッション情報の更新
+
+```
+横幅600px以上1,000pixel以下、　データ形式：psd / eps / gif / jpg / png　にてメール添付ください。
+長方形での掲載になりますので、トリミング頂く場合は、縦横比4:3にてお願いいたします。
+※写真は、セミナー詳細ページにのみ掲載いたします。
+```
+
+## 告知のための相談
+
+吉本さんにtwitterで告知をだしてもらおう
+事前に発表資料をみせて、内容をすりあわせしておきたい。
+
+例: https://twitter.com/_clear_code/status/1496681291156275211
+
+## zoomリハーサルの希望
+
+リハーサルの希望日程の回答が求められている
+以下の回答欄をうめる。
+
+```
+【回答フォーム】
+--------------------------------------------------
+■リハーサル参加者名
+※複数で参加の場合は、全員の名前(苗字)を記載してください
+[                     ]                   
+
+■OSCオンラインでの講師経験（あり・なし）
+※複数参加の場合は、各々の経験の有無を記載してください
+[                     ]                                   
+
+■リハーサル不要の方は、その旨お知らせください
+（OSCオンラインで初めて講演される方は、なるべくリハーサル実施をお願いしています）
+[                     ]
+
+■希望実施日
+[               ] ←下記選択肢から希望日を入力
+
+1)3/7(月),3/9(水)どちらでもOK
+2)3/7(月)のみ
+3)3/9(水)のみ
+4)その他、都合が悪い方は下の設問にご入力ください
+
+■実施時間
+[               ] ←下記選択肢から希望時間帯や、NGの時間帯を入力
+
+1)どの時間帯でもOK
+2)午前中
+3)13:00-18:00
+4)18:00以降
+5)20:00〜の合同説明会&練習会に参加（希望者をまとめて実施）
+　※Zoom環境に慣れていて、OSCのやり方のみを確認したい方向け。
+
+■上記日程の都合が悪い方は、別途調整しますのでご入力をお願いします
+
+[                     ]  ←希望日時などを入力
+```
+
+## 発表ネタと時間のすりあわせ
+
+前半(20分)
+
+https://github.com/kenhys/rabbit-slide-kenhys-osc2022-online-spring-fluentd/
+コミュニティー関連でこれまで改善してきたことを話す
+
+後半(20分)
+
+Fluentdの最新情報を話す
+
+* CNCFとの関係はいまどうなっているのか
+* ディストリビューションの違い
+　* TD Agent vs Calyptia Fluentd
+* どんな方針で開発をしているのか
+  * バージョンニングの方針と新機能
+* どこから最新情報を得るのがよいのか
+  * https://www.fluentd.org/blog/
+  * https://www.clear-code.com/blog/ これはセーフ？
+* Dockerイメージのサポート状況
+  * windows server 2004は終了
+* 各マイナーバージョンの新機能
+  * v1.12系
+  * v1.13系
+  * v1.14系
+* Fluentdのライフサイクルは今後どうなるのか
+
+最後に質問をうける(5分くらい)

data/fluentd.md

@@ -0,0 +1,249 @@
+# OSSを継続的に\\nメンテナンスしていく\\n仕組みづくり
+
+subtitle
+:  Fluentdの事例
+
+author
+:  Kentaro Hayashi
+
+content-source
+:  OSC2022 Online/Spring
+
+allotted-time
+:  20m
+
+theme
+:  .
+
+# 今日お話すること
+
+* OSS(Fluentd)を継続的にメンテナンスしていく仕組みづくり
+  * リリースするための仕組みを改善したこと
+  * よいフィードバックをもらうために工夫したこと
+  * プラグインを引き取る仕組みがあること
+
+# Fluentdとは
+
+![](images/fluentd.png){:relative-height="90"}
+
+{::note}https://docs.fluentd.org/quickstart{:/note}
+
+
+# 最新のリリース
+
+* v1.14.5 (2022/02/09)
+  * `in_http`で`application/x-ndjson`をサポート
+  * `out_forward`がハングする不具合修正
+
+# 定期的にリリース
+
+* Fluentd
+  * おおよそ2ヶ月ごとにメンテナンスリリース
+  * 修正をはやくユーザーに届ける
+    * masterではなおってます、というのを少なく
+
+# リリース作業
+
+* Fluentd gemの公開
+* ブログ記事公開
+  * {::note}https://www.fluentd.org/blog/{:/note}
+* Dockerイメージの公開
+* TD Agentの公開(随時)
+
+# 最新パッケージ版
+
+* TD Agent 4.3.0 (2021-12-13)
+  * Fluentd+プラグイン集
+  * 各種プラットフォーム向け(deb,rpm,msiなど)
+  * おおよそ4ヶ月ごとリリース
+* Calyptia Fluentd
+
+# 従来のパッケージの課題
+
+* パッケージを簡単につくれる・維持できる仕組みが必要
+
+# TD Agent v3
+
+* Omnibusベースのビルドシステム
+  * バンドルしたOpenSSLを使う
+  * 環境を整えるまでが大変😟
+  * 特定の人だけがビルドできる状態😟
+    * 属人化したリリース🤔
+
+# TD Agent v4
+
+* fluent-package-builder
+  * Dockerベースのビルドに刷新
+    * 環境構築や属人化の問題を解決
+  * arm64のサポート
+  * GitHub ActionsによるCI
+{::note}https://github.com/fluent/fluent-package-builder{:/note}
+
+
+# 注意喚起
+
+* TD Agent v3はすでにEOLです
+  * {::note}https://www.fluentd.org/blog/schedule-for-td-agent-3-eol{:/note}
+  * v4への移行手順も案内しています
+    * {::note}https://www.fluentd.org/blog/upgrade-td-agent-v3-to-v4{:/note}
+
+# 今日お話すること
+
+* OSS(Fluentd)を継続的にメンテナンスしていく仕組みづくり
+  * ~~リリースするための仕組みを改善したこと~~
+  * よいフィードバックをもらうために工夫したこと
+  * プラグインを引き取るしくみがあること
+
+
+# コミュニティーサポート
+
+* GitHub Issues
+  * {::note}https://github.com/fluent/fluentd/issues{:/note}
+* Discource
+  * {::note}https://discuss.fluentd.org/{:/note}
+  * GitHub Discussionsへ移行
+    * {::note}https://github.com/fluent/fluentd/discussions{:/note}
+* Slack 
+  {::note}https://fluent-all.slack.com/{:/note}
+
+
+# 従来のGitHub Issueの課題
+
+* {::note}https://github.com/fluent/fluentd/issues{:/note}
+
+![](images/fluentd-issues.png)
+
+# ありがちなこと(1)
+
+* Fluentdと直接関係ないプラグインの質問がくる
+ 
+![](images/non-fluentd-issue.png)
+
+# ありがちなこと(2)
+
+* 再現に必要な情報が不足
+
+![](images/missing-required-information.png)
+
+
+# 各種ガイドラインを\\n読まない……ことも
+
+![](images/issue-template.png)
+
+# なぜこうなるのか？
+
+* それなりに使われているソフトウェアでありがちなこと
+  * 背景もばらばらな人がフィードバックしてくれる
+  * 報告する人がわかっていることは省略する傾向にある
+* 再現に必要な情報が不足している
+
+# やりたいこと
+
+* よいフィードバックをもらいたい
+  * 本体の不具合や機能に関する要望など
+  * **再現可能な情報**が含まれている
+
+# 対策
+
+* GitHubのissueの役割を**仕組みで**しぼる
+  * 不具合報告 or 機能の要望のみにする
+  * 単なる使い方の質問のissueで埋もれない
+  * プラグインに関するissueに埋もれない
+
+# GitHub Issue Formsを使って報告するときに選択させる
+
+![](images/list-issue-forms.png)
+
+{::note}https://github.com/fluent/fluentd/issues/new/choose{:/note}
+
+# 使い方を知りたい人向け
+
+* GitHubのissueからdiscuss(Discource)への誘導
+  * 課題: 開発者以外で回答する人が不足😞
+  * 開発者側でトラッキングがしにくい😞
+  * 結果: あまりうまくいかなかった
+
+{::note}https://discuss.fluentd.org/{:/note}
+
+# 従来のIssueテンプレート
+
+![](images/issue-template.png)
+
+# 従来のIssueテンプレート
+
+* 入力項目が別れていない
+* 必須項目を指定できない
+* テンプレートを消して報告してくる強者も
+
+# 集めたい項目
+
+* バグの内容
+* 動作環境
+* 再現方法
+* 期待する挙動
+* エラーログ
+* 設定内容
+
+# GitHub\\nIssue Formsを活用
+
+![](images/issue-forms.png)
+
+{::note}https://github.com/fluent/fluentd/issues/new?assignees=&labels=&template=bug_report.yaml{:/note}
+
+
+# Issueのメンテナンス
+
+* 反応がないIssueというのもある
+  * 放置されたIssueはGitHub Actionで閉じる
+
+{::note}https://github.com/actions/stale{:/note}
+
+# 工夫したことまとめ
+
+* Issueの役割を明確にする(不具合・要望)
+* Issue Formsで必要な情報を集める
+* 古いIssueをGitHub Actionsで閉じる
+
+# 今日お話すること
+
+* Fluentdを継続的にメンテナンスしたい
+  * ~~リリースするための仕組みを改善したこと~~
+  * ~~よいフィードバックをもらうために工夫したこと~~
+  * プラグインを引き取るしくみがあること
+
+# Fluentdとプラグイン
+
+* 多くの3rdパーティープラグインがある
+* なかにはメンテナンスを継続できないケースも
+
+{::note}https://www.fluentd.org/plugins{:/note}
+
+# fluent-plugins-nursery
+
+* メンテナンスを継続するためのプロジェクト
+* リポジトリを移行してメンテナンスを継続
+* もちろん配下で開発し続けてもよい
+
+{::note}https://github.com/fluent-plugins-nursery/{:/note}
+
+# メンテナンスを移行するには
+
+* contactリポジトリで移行の相談
+  {::note}https://github.com/fluent-plugins-nursery/contact{:/note}
+* issueでownershipの移転のための手続きを実施
+  * 最近の事例: fluent-plugin-remote_syslog
+
+# よりオープンな開発方針
+
+* GitHub Project
+  * 実験的にプロジェクトメンバーで採用
+  * 次のバージョンに入れるものとかを相談
+
+{::note}https://github.com/orgs/fluent/projects/4{:/note}
+
+# さいごに
+
+* フィードバックを歓迎しています
+  * バグに遭遇したらGitHubのIssueとして報告する
+  * 既存のissueにコメントする(助け合いの精神で！)
+* 開発に関しては次の発表で！

data/theme.rb

@@ -0,0 +1,7 @@
+@default_font = "Ubuntu"
+@monospace_font = "Ubuntu"
+# Use smaller title font size
+@x_large_font_size = @x_large_font_size * 0.8
+include_theme("lightning-clear-blue")
+@slide_show_loop = true
+

metadata

@@ -0,0 +1,72 @@
+--- !ruby/object:Gem::Specification
+name: rabbit-slide-kenhys-osc2022-online-spring-fluentd
+version: !ruby/object:Gem::Version
+  version: 2022.03.12.1
+platform: ruby
+authors:
+- Kentaro Hayashi
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2022-03-10 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rabbit
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.0.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.0.2
+description: This is private repository.
+email:
+- kenhys@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".rabbit"
+- README.md
+- Rakefile
+- config.yaml
+- development.md
+- fluentd.md
+- images/fluentd-issues.png
+- images/fluentd.png
+- images/issue-forms.png
+- images/issue-template.png
+- images/list-issue-forms.png
+- images/missing-required-information.png
+- images/non-fluentd-issue.png
+- pdf/osc2022-online-spring-fluentd-fluentd.pdf
+- theme.rb
+homepage: https://slide.rabbit-shocker.org/authors/kenhys/osc2022-online-spring-fluentd/
+licenses:
+- CC-BY-SA-4.0
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.2.32
+signing_key: 
+specification_version: 4
+summary: OSC 2022 Online Spring Fluentd
+test_files: []