ccuploader

README

CC Uploader

Note: This repository should be imported as code.cloudfoundry.org/cc-uploader.

CC Bridge component to enable Diego to upload files to Cloud Controller's blobstore

Uploading Droplets & Build Artifacts

Uploading droplets & build artifacts via CC involves crafting a correctly-formed multipart request. For Droplets we also poll until the async job completes.

Testing

To specify a remote cloud controller to test against, use the following environment variables:

CC_ADDRESS the hostname for a deployed CC CC_USERNAME, CC_PASSWORD the basic auth credentials for the droplet upload endpoint CC_APPGUID a valid app guid on that deployed CC

####Learn more about Diego and its components at diego-design-notes

Generating cert fixtures

First generate certs for mTLS connection between cc_uploader (client) and cloud_controller (server)

cd fixtures
echo "Generating CA"
certstrap --depot-path . init --passphrase '' --common-name cc_uploader_ca_cn --expires "10 years"
echo "Generating server csr"
certstrap --depot-path . request-cert --passphrase '' --common-name cc_cn --domain cc_cn  --ip 127.0.0.1
echo "Generating server cert"
certstrap --depot-path . sign cc_cn --CA cc_uploader_ca_cn --expires "10 years"
echo "Generating client csr"
certstrap --depot-path . request-cert --passphrase '' --common-name cc_uploader_cn --domain cc_uploader_cn --ip 127.0.0.1
echo "Generating client cert"
certstrap --depot-path . sign cc_uploader_cn --CA cc_uploader_ca_cn --expires "10 years"

and once you've generated those, generate certs mTLS connection between the Diego cell (client) and cc_uploader (server)

cd certs/
cp ../cc_uploader_ca_cn.crt ca.crt
cp ../cc_uploader_ca_cn.key ca.key
certstrap --depot-path . request-cert --passphrase '' --domain '*.localhost,localhost' --ip 127.0.0.1
mv \_.localhost.csr server.csr
mv \_.localhost.key server.key
certstrap --depot-path . sign server --CA ca --expires "10 years"
certstrap --depot-path . request-cert --passphrase '' --common-name client --domain client --ip 127.0.0.1
certstrap --depot-path . sign client --CA ca --expires "10 years"

Documentation

Index

• Constants
• Variables

Constants

const (
	UploadDropletRoute        = "UploadDroplet"
	UploadBuildArtifactsRoute = "UploadBuildArtifacts"
)

Variables

var Routes = rata.Routes{
	{Name: UploadDropletRoute, Method: "POST", Path: "/v1/droplet/:guid"},
	{Name: UploadBuildArtifactsRoute, Method: "POST", Path: "/v1/build_artifacts/:app_guid"},
}