How to Create an App Using V3 of the CC API

1. Find the GUID of your space and set an APP_NAME:

CF_API_ENDPOINT=$(cf api | grep "API endpoint" | awk '{print $3}')
SPACE_GUID=$(cf space `cf target | tail -n 1 | awk '{print $2}'` --guid)
APP_NAME=[your-app-name]

1. Create an empty app (docs):

Here is the most common way:

APP_GUID=$(cf curl /v3/apps -X POST -d "{\"name\": \"${APP_NAME}\", \"relationships\": {\"space\": {\"data\": {\"guid\": \"${SPACE_GUID}\"}}}}" | tee /dev/tty | jq -r .guid)

1. Create an empty package for the app (docs):

PACKAGE_GUID=$(cf curl /v3/packages -X POST -d "{\"type\":\"bits\", \"relationships\": {\"app\": {\"data\": {\"guid\": \"$APP_GUID\"}}}}" | tee /dev/tty | jq -r .guid)

Note: Other package types are also supported. See documentation for Create a Package.

1. If your package is type buildpack, create a ZIP file of your application:

zip -r my-app.zip *

Note: The zip file should not have a folder as the top-level item (e.g. create the zip file from within your app’s directory)

1. If your package is type buildpack, upload your bits to your new package (docs):

curl $CF_API_ENDPOINT/v3/packages/$PACKAGE_GUID/upload -F bits=@"my-app.zip" -H "Authorization: $(cf oauth-token | grep bearer)"

1. Stage your package and create a build (docs):

BUILD_GUID=$(cf curl /v3/builds -X POST -d '{ "package" : { "guid" : "'$PACKAGE_GUID'" } }' | tee /dev/tty | jq -r .guid)

Note: The output of this command includes your new build's GUID

1. Wait for the state of the new build to reach STAGED:

watch cf curl /v3/builds/$BUILD_GUID

1. Get the droplet corresponding to the staged build:

DROPLET_GUID=$(cf curl /v3/builds/$BUILD_GUID | jq -r '.droplet.guid')

1. Assign the droplet to the app:

cf curl /v3/apps/$APP_GUID/relationships/current_droplet -X PATCH -d '{"data": {"guid": "'$DROPLET_GUID'"}}'

1. Create a route:

CF_TRACE=true cf create-route [space-name] [domain-name] -n [host-name]
ROUTE_GUID=[copy route's GUID under metadata->guid of the last response]

1. Map the route to your app (docs):

cf curl /v3/route_mappings -X POST -d '{"relationships": {"route": {"guid": "'$ROUTE_GUID'"}, "app": {"guid": "'$APP_GUID'"} } }'

1. Start your app (docs):

cf curl /v3/apps/$APP_GUID/start -X PUT

1. Visit your app at the new route to confirm that it is up