rabbit-slide-kenhys-tokyodebian-tag2upload 2024.07.20.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 539b157f4bbff905a64814df8034911d4163a7049127cabda9bb56c7debff540
+  data.tar.gz: 9020834e1785eeff8888705987dca9dd3376248c086cafcefcdc3dd5b31b055f
+SHA512:
+  metadata.gz: f31418015b3130a1a41eb07e7be45fba292b17c9dd7190abdfd89f51502f8bfd2c572a65f2f388d05cd7321d01743176181c2ecc38ed6d092976d7643c316ff5
+  data.tar.gz: cc895dfd29cf46f0333c5ec8689646b7b060fedf7a64f53cb96139a71ac98b673af8eda032a62095d3c7d9172e6b3261a60687756e0fe4fa57dbaaa6b23fc7e5

data/.rabbit

@@ -0,0 +1 @@
+--size=1920,1080 tag2upload.md

data/README.md

@@ -0,0 +1,42 @@
+# Tokyo Debian tag2upload
+
+## How to show
+
+  % rabbit
+
+## How to install
+
+  % gem install rabbit-slide-kenhys-tokyodebian-tag2upload
+
+## How to create PDF
+
+  % rake pdf
+
+# References
+
+* tag2upload (git-debpush) service architecture - draft
+  * https://lists.debian.org/debian-dak/2019/07/msg00025.html
+  * Ian Jackson氏によるドラフトの投稿
+
+* [tag2upload - uploads, made automatically and fully traceably, from git](https://www.youtube.com/watch?v=1ohpZ4Xj0iQ)
+  * MiniDebConf Cambridge 2023 (2023年11月開催)のプレゼンテーション
+
+* General Resolution to deploy tag2upload
+  * https://lists.debian.org/debian-vote/2024/06/msg00561.html
+  * Sean Whitton氏によるGRの提案
+
+* Security review of tag2upload
+  * https://lists.debian.org/debian-vote/2024/06/msg00004.html
+  * Russ Allbery氏による設計のレビュー
+
+* Summary of the current state of the tag2upload discussion
+  * https://lists.debian.org/debian-vote/2024/06/msg00456.html
+  * Russ Allbery氏による議論のまとめ
+
+* Answers to some Frequently Asked Questions (FAQ)
+  * https://salsa.debian.org/dgit-team/dgit/-/blob/master/TAG2UPLOAD-FAQ.md
+  * tag2uploadに関するFAQ
+
+* Debian debate over tag2upload reaches compromise
+  * https://lwn.net/Articles/978324/
+  * tag2uploadに関するあれこれをまとめている記事

data/Rakefile

@@ -0,0 +1,30 @@
+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
+
+desc "Extract slide as a image"
+task :extract do
+  9.times do |i|
+    sh("pdftk", "slides.pdf", "cat", "#{i+1}", "output", "images/slides#{i+1}.pdf")
+    sh("pdftocairo", "-png", "-singlefile", "images/slides#{i+1}.pdf", "images/slides#{i+1}")
+  end
+end
+
+desc "Show mini slide to preview"
+task :minislide do
+  sh("rabbit", "-w", "960", "-h", "540")
+end

data/config.yaml

@@ -0,0 +1,25 @@
+---
+id: tokyodebian-tag2upload
+base_name: tag2upload
+tags:
+- rabbit
+- debian
+- tag2upload
+presentation_date: 2024-07-20
+presentation_start_time:
+presentation_end_time:
+slideshare_id:
+version: 2024.07.20.2
+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: kenhys

data/q.md

@@ -0,0 +1,13 @@
+## 疑問点
+
+* タグ打ったあと、rejectされたらどうするのだろうか
+* salsa.d.oとdgit.d.oの内容って一致するのかそれとも、リリースごとのコミットになるのかどうなんだろう
+  * salsa.d.oだけだと、salsa.d.oが改ざんされると気づきにくい dgit.d.oがあることで、改ざんされても記録はdgit.d.oに残るのでトレースできる
+    https://lists.debian.org/debian-vote/2024/06/msg00004.html
+* どこかのチームで導入して、それから本格導入するのがいいんじゃないの？なんでいきなりGRに持ち込んだんだろう
+* dgit.d.oがすでにあるのかと思ったけどそうじゃない？ 別のgitホスティングを立ち上げる必要がないというのがよくわからん
+
+* dgit.d.oからソースパッケージを生成して検証するような仕組みがないといけないのではないか。
+  * でもいまもuploaderの内容を信頼しているのでデグレしているわけではないという判断
+* TCじゃなくてGRになったのはなぜか
+  * FAQだと

data/tag2upload.md

@@ -0,0 +1,236 @@
+# General Resolution:\\ntag2uploadは\\nDebianにどんな変化を\\nもたらすのか
+
+subtitle
+:  GR: tag2uploadの内容をふんわり理解する
+
+author
+:  Kentaro Hayashi
+
+institution
+:  ClearCode Inc.
+
+content-source
+:  2024年07月 東京エリア・関西合同Debian勉強会
+
+allotted-time
+:  25m
+
+theme
+:  .
+
+# スライドは\\nRabbit Slide Showにて公開済み
+
+* General Resolution: tag2upload Debianにどんな変革をもたらすのか
+  * {::note}<https://slide.rabbit-shocker.org/authors/kenhys/tokyodebian-tag2upload-202407>{:/note}
+
+# 本日の内容
+
+* DebianのGR: tag2uploadについて
+* tag2uploadはどういうものなのか
+* tag2uploadが議論となった背景
+* tag2uploadで解決される問題
+
+## note
+
+# 本日の内容
+
+* **DebianのGR: tag2uploadについて**
+* tag2uploadはどういうものなのか
+* tag2uploadが議論となった背景
+* tag2uploadで解決される問題
+
+# General Resolution to deploy tag2upload
+
+![](images/tag2upload-gr.png){:relative-height="90"}
+
+{:.center}
+{::note}<https://www.debian.org/vote/2024/vote_002>{:/note}
+
+# General Resolution to deploy tag2upload (1)
+
+tag2uploadでDDやDMがgit-debpush(1)を使ってgit tagに署名してアップロードできるようにする
+
+* tag2uploadをDebian公式なインフラへと組み込む
+* Debian憲章にもとづいて、tag2uploadサービスからのアップロードを信頼できるものとして受け入れるようにする(ftpmasterはこの決定に従ってね)
+
+# General Resolution to deploy tag2upload (2)
+
+* tag2uploadの将来的な変更はGRとかじゃなくて通常のDebianの開発プロセスに則って実施するよ
+* この決定はメンテナに特定のgitでのワークフローを強制するものではないよ
+
+# GR: tag2upload, text of proposal
+
+* <https://lists.debian.org/debian-vote/2024/06/msg00561.html>
+  * 2024/06/27 Sean Whitton氏によってtag2uploadが提案がなされる
+  * Sean Whitton氏やIan Jackson氏が中心になってtag2uploadのしくみを設計
+
+# General Resolution to deploy tag2upload (要約)
+
+* tag2uploadはgit tagに署名されていたらそれをもとにソースパッケージのアップロードまで代行してくれるしくみを導入するもの
+* **GRによってtag2uploadのしくみをftpmasterに採用してもらうことをねらっている**
+  * GRによる解決を図るのはある意味最終手段
+    * ftpmasterの方針をひっくり返すには(説得に失敗したら)GRしかない
+
+# GR: tag2uploadの最新情報
+
+* Re: General Resolution to deploy tag2upload
+  * <https://lists.debian.org/debian-vote/2024/07/msg00025.html>
+  * GRはSean氏によって撤回された
+    * tag2uploadの仕様を変更することによりftpmasterとの合意形成できたため
+
+## note
+
+GRがvoteまですすんだら、ルールに則っているとはいえこじれたままになってしまう危険があった。
+
+# 本日の内容
+
+* DebianのGR: tag2uploadについて
+* **tag2uploadはどういうものなのか**
+* tag2uploadが議論となった背景
+* tag2uploadで解決される問題
+
+# MiniDebConf Cambridge 2023
+
+* tag2upload - uploads, made automatically and fully traceably, from git
+  * MiniDebConf Cambridge 2023 (2023年11月開催)のプレゼンが参考になる
+    * <https://www.youtube.com/watch?v=1ohpZ4Xj0iQ>
+
+# 伝統的なパッケージの更新
+
+![](images/slides2.png){:relative-height="90"}
+
+{:.center}
+{::note}<https://www.youtube.com/watch?v=1ohpZ4Xj0iQ> より引用{:/note}
+
+# 最近のパッケージの更新
+
+![](images/slides4.png){:relative-height="90"}
+
+{:.center}
+{::note}<https://www.youtube.com/watch?v=1ohpZ4Xj0iQ> より引用{:/note}
+
+## note
+
+salsaが導入されたけどどのようにソースパッケージが生成されるかは不透明
+
+# tag2uploadの導入でどうなるか
+
+![](images/slides5.png){:relative-height="90"}
+
+{:.center}
+{::note}<https://www.youtube.com/watch?v=1ohpZ4Xj0iQ> より引用{:/note}
+
+# tag2uploadの進行状況
+
+* ✅tag2uploadのしくみのデザイン
+* ✅git tagに署名するgit-debpushの実装
+* ✅dgitサーバーの稼働 (git.dgit.debian.org)
+* ✅ソースパッケージ(.dsc)を生成するしくみの実装
+* ✅tag2uploadのしくみのレビュー
+
+# tag2uploadのこれから
+
+* ❌webhookとジョブを動かすサービスの検討(DSAと議論が必要)
+* ❌tag2uploadを試験稼働させる(DSAと議論が必要)
+* ❌ベータ稼働、ユーザーからのフィードバック等
+
+
+# 本日の内容
+
+* DebianのGR: tag2uploadについて
+* tag2uploadはどういうものなのか
+* **tag2uploadが議論となった背景**
+* tag2uploadで解決される問題
+
+# tag2uploadは急にでてきたわけじゃない
+
+* 2019年7月: Ian Jackson氏により設計の草稿が示される
+  * <https://lists.debian.org/debian-dak/2019/07/msg00025.html>
+  * 当時ftpmasterを説得しきれず立ち消えになった模様
+
+# [RFC] General Resolution to deploy tag2upload
+
+* 2024年6月 Sean WhittonさんによりGRの草稿が提示される
+  * <https://lists.debian.org/debian-vote/2024/06/msg00000.html>
+    * tagに署名をするだけでは不十分ではないか(ftpmaster)
+      * リリースを意図したアーカイブになっていることを担保すべき
+      * 例: 手元でビルドしないと得られないメタデータ(チェックサム)の付与
+    * tag2uploadのコンセプトと相容れない(tag2upload推進派)
+
+# なぜGeneral Resolutionが提案されたのか
+
+* GR: General Resolution
+  * Debianにおいて物事を投票で決めるしくみ
+  * DPLや権限を委譲されたチームの決定を**覆すことができる**(Debian憲章より)
+    * 2019年のときと同じような議論が繰り返された(tag2upload推進派)
+    * tag2upload推進派は現状のデザインをそのまま採用させたい
+
+# どのような合意形成が行われたか
+
+* t2u in the archive (was: General Resolution to deploy tag2upload)
+  * <https://lists.debian.org/debian-vote/2024/06/msg00602.html>
+  * タグに署名をするのに加えて:
+    * tagにひもづいた`git ls-files --format="%(objectmode) %(objectname) %(path)"`を含める
+    * gitのアーカイブ(SOURCE_VERSION.git.tar.xz)を.changesに含める
+      * メンテナーが意図したアーカイブの内容であることを検証できるようにする
+
+# 本日の内容
+
+* DebianのGR: tag2uploadについて
+* tag2uploadはどういうものなのか
+* tag2uploadが議論となった背景
+* **tag2uploadで解決される問題**
+
+# tag2uploadの導入でどうなるか(再掲)
+
+![](images/slides5.png){:relative-height="90"}
+
+{:.center}
+{::note}<https://www.youtube.com/watch?v=1ohpZ4Xj0iQ> より引用{:/note}
+
+# 開発者にとって何が変わるか
+
+* パッケージメンテナー(DD or DM)のやること
+  * ソースパッケージのアップロードは不要になる
+  * tagを打つときに署名を付与してsalsa.d.oにgit debpushするだけでよい
+* tag2uploadは利用しなくてもよい(オプションだから)
+
+# ユーザーにとって何が変わるか
+
+* git.dgit.d.oからタグの打たれたソースコードを入手できる
+  * gitを経由してソースを取得し、より再現性のあるビルドが行える(salsa.d.oとの比較)
+  * 一般ユーザーにはあんまり影響はない
+
+# Debianにとって何が変わるか
+
+* トレーサビリティの向上
+  * ソースパッケージを一貫したやりかたで生成できることが担保される
+  * 変なコードの混入を防ぎやすくなる
+    * git.dgit.d.oは追記のみなのであとから検証できる
+  * salsa.d.oが現状を正しく反映するようになる
+    * salsa.d.oと最新のソースパッケージの内容が違うとかありがち
+
+# tag2uploadを使うには
+
+* 次のようにして初期セットアップする(gbp使っている場合)
+  * (アップロード前の)新バージョンの準備ができたら実施する
+    * 既定でgit pushするので注意
+
+```
+$ sudo apt install git-debpush
+$ cd (salsa.d.oからcloneしたディレクトリ)
+$ git debpush --gbp
+```
+
+# さいごに
+
+* tag2uploadによりパッケージの透明性が高まるかも
+* DSAとの調整次第なのでいつ導入されるかは不明
+* またtag2uploadを採用するかどうかはメンテナー次第
+* 単一リポジトリはサポートされていないのが課題(Rubyパッケージとか)
+
+# 参考
+
+* Debian debate over tag2upload reaches compromise
+  * https://lwn.net/Articles/978324/
+  * tag2uploadに関するあれこれをまとめている記事

data/theme.rb

@@ -0,0 +1,5 @@
+@default_font = "Ubuntu"
+@monospace_font = "Ubuntu"
+include_theme("debian")
+#@slide_show_span = 1300
+@slide_show_loop = true

metadata

@@ -0,0 +1,79 @@
+--- !ruby/object:Gem::Specification
+name: rabbit-slide-kenhys-tokyodebian-tag2upload
+version: !ruby/object:Gem::Version
+  version: 2024.07.20.2
+platform: ruby
+authors:
+- Kentaro Hayashi
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2024-07-16 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: ''
+email:
+- kenhys@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".rabbit"
+- README.md
+- Rakefile
+- config.yaml
+- images/slides1.pdf
+- images/slides2.pdf
+- images/slides2.png
+- images/slides3.pdf
+- images/slides4.pdf
+- images/slides4.png
+- images/slides5.pdf
+- images/slides5.png
+- images/slides6.pdf
+- images/slides7.pdf
+- images/slides8.pdf
+- images/slides9.pdf
+- images/tag2upload-gr.png
+- pdf/tokyodebian-tag2upload-tag2upload.pdf
+- q.md
+- slides.pdf
+- tag2upload.md
+- theme.rb
+homepage: https://slide.rabbit-shocker.org/authors/kenhys/tokyodebian-tag2upload/
+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.4.19
+signing_key:
+specification_version: 4
+summary: Tokyo Debian tag2upload
+test_files: []