GitHubのリポジトリ（３２個）を 覗いてみよう。

ただし、READMEだけね

なおと＠tnaoto

第６回 CloudFoundry輪読会

自己紹介

• たかはしなおと＠tnaoto

• CloudFoundryは業務外の 興味（趣味）で触ってます。

• rubyは読めも書けもしません。

• 夢：「会社に遊びに行くこと」

はじめに

• 輪読会前日に・・・４つ増えた！ （まぁいつ増えても変わらないわけですが）

• ということで、現在３２個です。

• これも混ぜてお送りします

• って書いたら今日35個になってたYO！

• 資料が雑でごめんなさい・・・ｍ（＿＿）ｍ

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日

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日！

bosh-release

• https://github.com/cloudfoundry/bosh-release

• README がないんですけど・・・

• 仕方ないので、src配下をみてみた

• パッケージ(deb)とか、tar.gzとか・・・

• 最初のコミットは2011年11月29日

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

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？)活発度不明

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月

cf-release

• https://github.com/cloudfoundry/cf-release • Cloud Foundry release

• なんかどっかで見たようなREADME マニュアルへの誘導とレビュー依頼の仕方が書いてあるような

• 仕方ないので中を覗いてみると、patchが入ってたりして、これをインストールの中で当てている

• cf以外の外部モジュールpatch等のため？ • XX-releaseはすべてBOSHのために存在するとのこと

• 最初のコミットは2012年4月4日

common

• https://github.com/cloudfoundry/common

• This repo contains code that is shared between inner/outer shell

• 各コンポーネントで共通のロジックが集められている

• 最初のコミットは2011年3月19日

dea

• https://github.com/cloudfoundry/dea

• 2012年5月16日に突如出現

• README なし

• 中身をみると、ただのrailsアプリ・・・ってDEAそのままでした

• 最初のコミットは2011年4月11日

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年・・・って元のものですね

gerrit_test

• https://github.com/cloudfoundry/gerrit_test

• READMEなし

• テストコミットしているだけのようで、fooとかbarしかない

• 最初のコミットは2011年4月14日

gonit

• https://github.com/cloudfoundry/gonit

• 2012年5月16日に出現

• Nothing to see here yet. Move along. と表示されて中身見えません。

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日

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日

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日

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日

oss-release

• https://github.com/cloudfoundry/oss-release

• Cloud Foundry OSS Tools Release

• srcには、各種OSSのバイナリが入っています

• releaseはセットアップ情報？

• とりあえずよくわからず → XX-releaseに従い、BOSHのためらしい

• 最初のコミットは2012年4月6日

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）

• 最初のコミットは、２０１２年２月９日

uaa

• https://github.com/cloudfoundry/uaa

• CloudFoundry User Account and Authentication (UAA) Server

• rubyとJavaで実装されているコンポ

• ビルドするためにmaven3.0.4を抱えることになる。

• 最初のコミットは２０１１年１０月１１日

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のストレージとセットのために使っているコンポらしいとのこと

• 最初のコミットは２０１１年８月１１日

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.

• 最初のコミットは２０１１年４月１１日

vcap-common

• https://github.com/cloudfoundry/vcap-common

• 今日（２０１２年５月１７日）増えてました

• READMEなし・・・

• vcap_common.gemspec →s.homepage = http://github.com/vmware-ac/core →４０４エラー。プライベートリポジトリですか。。。

• 結局なんでしょうこれ？

• 最初のコミットは２０１１年４月１１日

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の結果もないので、まだ使われてない？？詳しい情報求む

• 最初のコミットは、２０１２年４月１６日

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.

• 最初のコミットは２０１１年４月１１日

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クライアントとか

• 最初のコミットは、２０１１年９月１４日

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.

• 最初のコミットは２０１２年３月３日

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.

• 最初のコミットは、２０１１年１１月１７日

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.

• 最初のコミットは、２０１１年４月１１日

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.

• 最初のコミットは２０１１年９月１４日

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.

• 最初のコミットは２０１１年４月１１日

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 • 最初のコミットは２０１１年４月１１日

vmc

• https://github.com/cloudfoundry/vmc

• The VMware Cloud CLI. This is the command line interface to VMware's Application Platform

• 最初のコミットは２０１１年４月１１日

vmc-glue

• https://github.com/cloudfoundry/vmc-glue

• 本日（２０１２年５月１７日）出現

• READMEなし

• bin配下にvmcが１つあるだけ

• 新しいvmcの実装との中間のために用意されたもの。

• 最初のコミットは２０１２年５月１６日

vmc-lib

• https://github.com/cloudfoundry/vmc-lib

• 本日（２０１２年５月１７日）出現

• READMEなし

• 最初のコミットは２０１２年５月１４日

vmc-plugins

• https://github.com/cloudfoundry/vmc-plugins

• 本日（２０１２年５月１７日）出現

• READMEなし

• manifest.ymlのため？

• vmcの新しい実装ではプラグインを実装できるようになったため、そのためのもの。

• 最初のコミットは２０１２年５月１４日

以上

雑な資料ですみませんでした・・・