Dmitry,

Besides the great CPI V1 doc (for which I proposed refinements in [4]), I
notice you have planned a future page "Interactions between CPIs and BOSH
Agent" in the TOC.

I have few questions that might relate to this future page:

- In which cases should the cpi update the agent settings in the registry
(e.g. as AWS cpi is doing during create_vm [1]) w.r.t. letting bosh
director updating the registry from the returned cloud ids (as mentionned
into [2]) ?

- Examples of agent settings in [3] are great, where can the reference
specs/tests of the agent settings be found ? I wasn't able to spot them yet
in the bosh-agent repo. Are those settings called bootstrap settings and
saved into settings.json as mentionned into [5]? Same question for start up
settings (agent.json) which format seems different from bootstrap settings
( with ex in in [6] and [7].

Would it make sense to publish bosh-agent test result as a spec for the
agent settings (eg ginko verbose output), possibly in bosh ci (it seems to
only have test suite summary now [8])

- Where can be learned more about a bosh agent bootstraping typical process
(read agent.json bundled in the stemcell, then get an IP through dhcp, then
pull from meta-data server the agentid and registry, then pull complete
network config from remote bosh directory registry, then ready to receive
pings from director through ?), similar to [2] with more details ? In which
case is an ssh tunnel to serve the config registry to the agent is
necessary (is that limited to the deprecated micro-bosh mechanism ?)

Thanks again,

Guillaume.

[1]
https://github.com/cloudfoundry/bosh/blob/master/bosh_aws_cpi/spec/unit/create_vm_spec.rb#L111-L133
[2] http://bosh.io/docs/bosh-components.html "example component
interaction" section
[3] http://bosh.io/docs/cpi-api-v1.html#create-vm
[4] https://github.com/cloudfoundry/docs-bosh/pull/47
[5] http://bosh.io/docs/vm-config.html
[6]
https://github.com/cloudfoundry/bosh/blob/ede389a2e112e1b4f2dbc4495c08977da4439483/stemcell_builder/stages/bosh_vsphere_agent_settings/apply.sh#L7-L25
[7]
https://github.com/cloudfoundry/bosh/blob/ede389a2e112e1b4f2dbc4495c08977da4439483/stemcell_builder/stages/bosh_openstack_agent_settings/apply.sh#L12-L40
[8]
https://main.bosh-ci.cf-app.com/pipelines/bosh-agent/jobs/test-unit/builds/25