GitHubのリポジトリ（３２個）を 覗いてみよう。 ただし、READMEだけね

1. 第６回 CloudFoundry輪読会
GitHubのリポジトリ（３２個）を
覗いてみよう。
ただし、READMEだけね
なおと＠tnaoto

2. 自己紹介
• たかはしなおと＠tnaoto
• CloudFoundryは業務外の
興味（趣味）で触ってます。
• rubyは読めも書けもしません。
• 夢：「会社に遊びに行くこと」

3. はじめに
• 輪読会前日に・・・４つ増えた！
（まぁいつ増えても変わらないわけですが）
• ということで、現在３２個です。
• これも混ぜてお送りします
• って書いたら今日35個になってたYO！
• 資料が雑でごめんなさい・・・ｍ（＿＿）ｍ

4. acm
• https://github.com/cloudfoundry/acm
• Cloud Foundry Access Control Manager (ACM)
• The ACM is a service that allows cloud foundry
components to implement access control
features.
• The ACM documentation is at docs/Access-
Control-Manager-APIs.rst
• 最初のコミットは、2011年11月15日

5. bosh
• https://github.com/cloudfoundry/bosh
• BOSH
• Cloud Foundry BOSH is an open source tool chain
for release engineering, deployment and lifecycle
management of large scale distributed services.
In this manual we describe the architecture,
topology, configuration, and use of BOSH, as well
as the structure and conventions used in
packaging and deployment.
• 最初のコミットは、2010年8月18日！

6. bosh-release
• https://github.com/cloudfoundry/bosh-
release
• README がないんですけど・・・
• 仕方ないので、src配下をみてみた
• パッケージ(deb)とか、tar.gzとか・・・
• 最初のコミットは2011年11月29日

7. bosh-sample-release
• https://github.com/cloudfoundry/bosh-sample-
release
• This is a sample release repository for BOSH that
deploys a three tier LAMP application: a
wordpress blog which consists of a number of
apache servers running php & wordpress, fronted
by nginx, and using one mysql database for
storage.
最初のコミットはMar 06, 2012

8. caldecott
• https://github.com/cloudfoundry/caldecott
• caldecott
TCP over HTTP tunnel.
• vmc tunnelのことです
• http://blog.udcp.net/2011/12/01/caldecottの仕
組みvmc-tunnel/
• たぶんこのあたりを見れば・・・（ステマ）
• 最初のコミットは2011年10月21日
• 版数もあがってなく（0.0.5？)活発度不明

9. cf-docs
• https://github.com/cloudfoundry/cf-docs
• docs.cloudfoundry.com向けドキュメントの書き方？
CloudFoundry.comの情報はすべてオープンにすると
いう方針に従って、ドキュメントの作成の仕方もオープ
ンにしているのかも
• License
This work is licensed under a Creative Commons
Attribution-ShareAlike 3.0 License
• 最初のコミットは、2012年4月

10. cf-release
• https://github.com/cloudfoundry/cf-release
• Cloud Foundry release
• なんかどっかで見たようなREADME
マニュアルへの誘導とレビュー依頼の仕方が書いてある
ような
• 仕方ないので中を覗いてみると、patchが入ってたりして、
これをインストールの中で当てている
• cf以外の外部モジュールpatch等のため？
• XX-releaseはすべてBOSHのために存在するとのこと
• 最初のコミットは2012年4月4日

11. common
• https://github.com/cloudfoundry/common
• This repo contains code that is shared
between inner/outer shell
• 各コンポーネントで共通のロジックが集めら
れている
• 最初のコミットは2011年3月19日

12. dea
• https://github.com/cloudfoundry/dea
• 2012年5月16日に突如出現
• README なし
• 中身をみると、ただのrailsアプリ・・・ってDEA
そのままでした
• 最初のコミットは2011年4月11日

13. eventmachine
forked from eventmachine/eventmachine
• https://github.com/cloudfoundry/eventmachine
• What is EventMachine
• EventMachine is an event-driven I/O and lightweight
concurrency library for Ruby. It provides event-driven I/O
using the Reactor pattern, much like JBoss Netty, Apache
MINA, Python's Twisted, Node.js, libevent and libev.
• オリジナルのeventmachineから派生して、CloudFoundry向
けの修正が入っている
• 最初のコミットは2003年・・・って元のものですね

14. gerrit_test
• https://github.com/cloudfoundry/gerrit_test
• READMEなし
• テストコミットしているだけのようで、fooとか
barしかない
• 最初のコミットは2011年4月14日

15. gonit
• https://github.com/cloudfoundry/gonit
• 2012年5月16日に出現
• Nothing to see here yet. Move along.
と表示されて中身見えません。

16. health_manager
• https://github.com/cloudfoundry/health_manager
• 2012年5月16日に出現
• HealthManager 2.0
Health Manager 2.0 (HM-2) is a complete re-write of the original Health Manager.
• HM-2 monitors the state of the applications and ensures that started applications
are indeed running, their versions and number of instances correct.
Conceptually, this is done by maintaining a Known State of applications and
comparing it against the Expected State. When discrepancies are found, actions
are initiated to bring the applications to the Expected State, e.g., start/stop
commands are issued for missing/extra instances, respectively.
Additionally, Health Manager collects and exposes statistics and health status for
individual applications, as well as aggregates for frameworks, runtimes, etc.
• なにか置き換わる予定か・・・？
• 最初のコミットは2012年4月19日

17. membrane
• https://github.com/cloudfoundry/membrane
• Membrane
Membrane provides an easy to use DSL for specifying validators
declaratively. It's intended to be used to validate data received from
external sources, such as API endpoints or config files. Use it at the
edges of your process to decide what data to let in and what to
keep out.
• なんだか分からないので、grepしてみたけどひっかからず。なにこ
れ？
→各コンポが使っている設定値等のValidationを取ったりするよう
なTOOLが入っているらしい
• 最初のコミットは2012年4月30日

18. micro
• https://github.com/cloudfoundry/micro
• This repository is currently broken as I've just pulled
the micro cloud related code from the bosh repository.
• To get it working again:
• - switch to the new stemcell builder
• - change the console code to use the http-based agent
• 最初のコミットは2010年8月18日

19. oss-docs
• https://github.com/cloudfoundry/oss-docs
• There is a Cloud Foundry documentation set for open source developers,
and one for CloudFoundry.com users
• Open Source Developers: https://github.com/cloudfoundry/oss-docs
• CloudFoundry.com users: http://docs.cloudfoundry.com
• To make changes to our documentation, follow the [OSS
Contributions][OSS Contributions] steps and contribute to the oss-docs
repository.
• タイトルと言っていることがなんかおかしいですが、boshとvcapのセット
アップ等のドキュメントがあります
• 最初のコミットは2011年4月23日

20. oss-release
• https://github.com/cloudfoundry/oss-release
• Cloud Foundry OSS Tools Release
• srcには、各種OSSのバイナリが入っています
• releaseはセットアップ情報？
• とりあえずよくわからず
→ XX-releaseに従い、BOSHのためらしい
• 最初のコミットは2012年4月6日

21. oss-tools
• https://github.com/cloudfoundry/oss-tools
• Cloud Foundry Open Source Tools
• This repo contains various tools related to or
used by Cloud Foundry
• 入っているのは３つ（gerrit-cli、 pr-bounce、
sync_jenkins_jobs）
• 最初のコミットは、２０１２年２月９日

22. uaa
• https://github.com/cloudfoundry/uaa
• CloudFoundry User Account and
Authentication (UAA) Server
• rubyとJavaで実装されているコンポ
• ビルドするためにmaven3.0.4を抱えることに
なる。
• 最初のコミットは２０１１年１０月１１日

23. vblob
• https://github.com/cloudfoundry/vblob
• node.js blob service gateway.
• The blob service provides an S3-compatible HTTP endpoint
to an underlying storage provider. A driver model is used
for different providers. Currently the available drivers
include S3 (Amazon web services) or a local file system (FS)
driver.
• CloudFoundry.comがEMCのストレージとセットのために
使っているコンポらしいとのこと
• 最初のコミットは２０１１年８月１１日

24. vcap
• https://github.com/cloudfoundry/vcap
• VMware's Cloud Application Platform
• What is Cloud Foundry?
Cloud Foundry is an open platform-as-a-
service (PaaS). The system supports multiple
frameworks, multiple application
infrastructure services and deployment to
multiple clouds.
• 最初のコミットは２０１１年４月１１日

25. vcap-common
• https://github.com/cloudfoundry/vcap-common
• 今日（２０１２年５月１７日）増えてました
• READMEなし・・・
• vcap_common.gemspec
→s.homepage = http://github.com/vmware-
ac/core
→４０４エラー。プライベートリポジトリですか。。。
• 結局なんでしょうこれ？
• 最初のコミットは２０１１年４月１１日

26. vcap-concurrency
• https://github.com/cloudfoundry/vcap-
concurrency
• ```VCAP::Concurrency''' provides a small set of
classes that ease common tasks associated
with concurrent programming
• grepの結果もないので、まだ使われてな
い？？詳しい情報求む
• 最初のコミットは、２０１２年４月１６日

27. vcap-java
• https://github.com/cloudfoundry/vcap-java
• What is vcap-java ?
• The vcap-java repo contains Java libraries that
applications running on Cloud Foundry may
utilize. Applications can include cloudfoundry-
runtime library to easily access information about
services bound to the app, its environment, as
well as implementation of various namespace
elements. Cloud Foundry automatically includes
the auto-reconfiguration library as needed.
• 最初のコミットは２０１１年４月１１日

28. vcap-java-client
• https://github.com/cloudfoundry/vcap-java-client
• What is this component
The vcap-java-client repo contains a java client
library and tools for Cloud Foundry. The library
provides a set of classes that ultimately call the
core Cloud Foundry REST API
• Caldecott client とかmaven-pluginとかJavaクライ
アントとか
• 最初のコミットは、２０１１年９月１４日

29. vcap-node
• https://github.com/cloudfoundry/vcap-node
• 直下にはcf-runtimeのみ
• cf-runtime is a Node.js module that provides
API to Cloud Foundry platform. It provides
easy access to Cloud Foundry application
properties and services.
• 最初のコミットは２０１２年３月３日

30. vcap-ruby
• https://github.com/cloudfoundry/vcap-ruby
• What is this component
• The vcap-ruby repo contains the auto-reconfiguration
and cfruntime modules. cf-runtime is a client library
that makes it easier to connect to Cloud Foundry
services from your Ruby applications. The auto-
reconfiguration module is used internally by the Cloud
Foundry staging plugins to automatically connect Ruby
and Sinatra applications to Cloud Foundry services.
• 最初のコミットは、２０１１年１１月１７日

31. vcap-services
• https://github.com/cloudfoundry/vcap-services
• What is this component
The services repo contains a collection of sample
cloud foundry services.
The repo has a position in the overall vcap
namespace at vcap/services and uses the git
submodule mechanism to be mounted in that
location.
The code is exposed via the vcap-services repo.
• 最初のコミットは、２０１１年４月１１日

32. vcap-test-assets
• https://github.com/cloudfoundry/vcap-test-
assets
• What is vcap-test-assets ?
The vcap-test-assets repo contains various
assets needed by vcap-tests. It has a position
in the overall vcap namespace at vcap/test-
assets and uses the git submodule mechanism
to be mounted in that location.
• 最初のコミットは２０１１年９月１４日

33. vcap-tests
• https://github.com/cloudfoundry/vcap-tests
• What is vcap-tests ?
• The tests repo contains the basic verification tests
used to quickly validate that a release is
functional. It has a position in the overall vcap
namespace at vcap/tests and uses the git
submodule mechanism to be mounted in that
location.
• 最初のコミットは２０１１年４月１１日

34. vcap-tools
• https://github.com/cloudfoundry/vcap-tools
• Repository for Cloud Foundry tools
• VCAP Metric Collector
The collector will discover the various components on the message bus and query
their /healthz and /varz interfaces.
• dashboard
READMEなし。Java出かかれている。
• router_registrar
• vcap_registrar
• 最初のコミットは２０１１年４月１１日

35. vmc
• https://github.com/cloudfoundry/vmc
• The VMware Cloud CLI. This is the command
line interface to VMware's Application
Platform
• 最初のコミットは２０１１年４月１１日

36. vmc-glue
• https://github.com/cloudfoundry/vmc-glue
• 本日（２０１２年５月１７日）出現
• READMEなし
• bin配下にvmcが１つあるだけ
• 新しいvmcの実装との中間のために用意された
もの。
• 最初のコミットは２０１２年５月１６日

37. vmc-lib
• https://github.com/cloudfoundry/vmc-lib
• 本日（２０１２年５月１７日）出現
• READMEなし
• 最初のコミットは２０１２年５月１４日

38. vmc-plugins
• https://github.com/cloudfoundry/vmc-plugins
• 本日（２０１２年５月１７日）出現
• READMEなし
• manifest.ymlのため？
• vmcの新しい実装ではプラグインを実装できるよ
うになったため、そのためのもの。
• 最初のコミットは２０１２年５月１４日

39. 以上
雑な資料ですみませんでした・・・