Skip to content

Cloud Foundry - the open platform as a service project

License

Apache-2.0, Apache-2.0 licenses found

Licenses found

Apache-2.0
LICENSE
Apache-2.0
license.txt
Notifications You must be signed in to change notification settings

voxeolabs/cf-java-client

 
 

cf-java-client

Build Status

The cf-java-client repo contains a Java client library and tools for Cloud Foundry. Three major components are included in this repo.

Components

cloudfoundry-client-lib

The cloudfoundry-client-lib is a Java library that provides a Java language binding for the Cloud Foundry Cloud Controller REST API. The library can be used by Java, Groovy, and Scala apps to interact with a Cloud Foundry service on behalf of a user.

Read more

cloudfoundry-maven-plugin

The Cloud Foundry Maven plugin is a plugin for the Maven build tool that allows you to deploy and manage applications with Maven goals.

Read more

cloudfoundry-gradle-plugin

The Cloud Foundry Gradle plugin is a plugin for the Gradle build tool that allows you to deploy and manage applications with Gradle tasks.

Read more

Building

Prerequisites

Apache Maven

The cloudfoundry-client-lib and cloudfoundry-maven-plugin components are built with Apache Maven.

Gradle

The cloudfoundry-gradle-plugin component is built with Gradle.

Protocol Buffer compiler

The cloudfoundry-client-lib uses Protocol Buffers to get logs from the Cloud Foundry loggregator component. A protoc Protocol Buffer compiler is required at build time to compile message specifications. protoc version 2.5.0 is required.

On Linux with apt, run the install-protoc.sh script in this repository to compile protoc 2.5.0 from source.

On OSX with homebrew, install protoc with this command:

$ brew install protobuf

On Windows, download the protoc binary, unzip it, and put protoc.exe in the path.

After installing, run this command and check the output to make sure it is similar to the following:

$ protoc --version
libprotoc 2.5.0

Compiling and Packaging

To build cloudfoundry-client-lib and cloudfoundry-maven-plugin, run the following command from the project root directory:

$ mvn clean install

To build cloudfoundry-gradle-plugin, run the following command from the cloudfoundry-gradle-plugin sub-directory after building cloudfoundry-client-lib:

$ gradle clean install

Running Integration Tests

cloudfoundry-client-lib has an extensive set of integration tests which run against a Cloud Foundry service. To execute the integration tests, run the following command from the project root directory:

$ mvn -P integration-test clean install -Dccng.target=<endpoint> -Dccng.email=<username> -Dccng.passwd=<password> -Dccng.org=<organization> -Dccng.space=<space>

Following is a complete list of the -D parameters that can be passed to the integration test:

Parameter Description Required/Optional
ccng.target target Cloud Foundry endpoint (e.g. https://api.run.pivotal.io) required
ccng.email Cloud Foundry username required
ccng.passwd Cloud Foundry password required
ccng.org Cloud Foundry organization to run tests against required
ccng.space Cloud Foundry space to run tests against required
ccng.ssl trust self-signed certificates from target endpoint optional, default is false
vcap.mysql.label label of a MySQL service that can be created optional, default is cleardb
vcap.mysql.plan plan of a MySQL service that can be created optional, default is spark
http.proxyHost host name of an HTTP proxy optional
http.proxyPort port of an HTTP proxy optional

Important

Integration tests should be run against an empty Cloud Foundry space. The integration tests are destructive, and will delete any apps, services, routes, and domains existing in the target space.

Cloud Foundry Resources

Cloud Foundry Open Source Platform as a Service

Learn

Our documentation, currently a work in progress, is available here: http://cloudfoundry.github.com/

Ask Questions

Questions about the Cloud Foundry Open Source Project can be directed to our Google Groups.

File a bug

Bugs can be filed using Github Issues within the various repositories of the Cloud Foundry components.

OSS Contributions

The Cloud Foundry team uses GitHub and accepts contributions via pull request

Follow these steps to make a contribution to any of our open source repositories:

  1. Complete our CLA Agreement for individuals or corporations
  2. Set your name and email
$ git config --global user.name "Firstname Lastname"
$ git config --global user.email "[email protected]"
  1. Fork the repo
  2. Make your changes on a topic branch, commit, and push to github and open a pull request.

Once your commits are approved by Travis CI and reviewed by the core team, they will be merged.

About

Cloud Foundry - the open platform as a service project

Resources

License

Apache-2.0, Apache-2.0 licenses found

Licenses found

Apache-2.0
LICENSE
Apache-2.0
license.txt

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Java 85.8%
  • Groovy 13.8%
  • Other 0.4%