Cloud Foundry Resource
An output only resource (at the moment) that will deploy an application to a Cloud Foundry deployment.
Note: you must provide either
api: Required. The address of the Cloud Controller in the Cloud Foundry deployment.
username: Optional. The username used to authenticate.
password: Optional. The password used to authenticate.
client_id: Optional. The client id used to authenticate.
client_secret: Optional. The client secret used to authenticate.
organization: Required. The organization to push the application to.
space: Required. The space to push the application to.
skip_cert_check: Optional. Check the validity of the CF SSL cert. Defaults to
verbose: Optional. Invoke
CF_TRACE=trueto print all API calls made to Cloud Foundry.
out: Deploy an application to a Cloud Foundry
Pushes an application to the Cloud Foundry detailed in the source configuration. A manifest that describes the application must be specified.
manifest: Required. Path to a application manifest file.
path: Optional. Path to the application to push. If this isn't set then it will be read from the manifest instead.
current_app_name: Optional. This should be the name of the application that this will re-deploy over. If this is set the resource will perform a zero-downtime deploy.
environment_variables: Optional. It is not necessary to set the variables in manifest if this parameter is set.
docker_username: Optional. This is used as the username to authenticate against a protected docker registry.
docker_password: Optional. This should be the users password when authenticating against a protected docker registry.
show_app_log: Optional. Tails the app log during startup, useful to debug issues when using blue/green deploys together with the
no_start: Optional. Deploys the app but does not start it. This parameter is ignored when
--- jobs: - name: job-deploy-app public: true serial: true plan: - get: resource-web-app - task: build file: resource-web-app/build.yml - put: resource-deploy-web-app params: manifest: build-output/manifest.yml environment_variables: key: value key2: value2 resources: - name: resource-web-app type: git source: uri: https://github.com/cloudfoundry-community/simple-go-web-app.git - name: resource-deploy-web-app type: cf source: api: https://api.run.pivotal.io username: EMAIL password: PASSWORD organization: ORG space: SPACE skip_cert_check: false
- golang is required - version 1.9.x is tested; earlier versions may also work.
- docker is required - version 17.06.x is tested; earlier versions may also work.
- godep is used for dependency management of the golang packages.
Running the tests
The tests have been embedded with the
Dockerfile; ensuring that the testing
environment is consistent across any
docker enabled platform. When the docker
image builds, the test are run inside the docker container, on failure they
will stop the build.
Run the tests with the following command:
docker build -t cf-resource .
Please make all pull requests to the
master branch and ensure tests pass