.NET CloudFoundry Connectors
NOTICE: This repository has been relocated as a sub-directory under the Steeltoe repository. All issues and future development will be done under that repository.
This repository contains several connectors which simplify the process of connecting to services on CloudFoundry.
Windows Master (Stable):
Windows Dev (Less Stable):
Linux/OS X Master (Stable):
Linux/OS X Dev (Less Stable):
.NET Runtime & Framework Support
The connectors are intended to support both .NET 4.6.1+ and .NET Core (CoreCLR/CoreFX) runtimes. Note that some connectors only support .NET 4.6.1+ since the libraries they depend on do not support .NET Core.
Where supported the connectors are built and unit tested on Windows, Linux and OSX.
While the primary usage of the connectors is intended to be with ASP.NET Core applications, they should also work fine with UWP, Console and ASP.NET 4.x apps.
Depending on their level of support, the connectors and samples have been tested on .NET Core 2.0, .NET 4.6.x, and on ASP.NET Core 2.0.
Usage
For more information on how to use these components see the online Steeltoe documentation.
Nuget Feeds
All new connector development is done on the dev branch. More stable versions of the connectors can be found on the master branch. The latest prebuilt packages from each branch can be found on one of two MyGet feeds. Released version can be found on nuget.org.
Building Pre-requisites
To build and run the unit tests:
- .NET Core SDK 2.0.3 or greater
- .NET Core Runtime 2.0.3
Building Packages & Running Tests - Windows
To build the packages on windows:
- git clone ...
- cd
<clone directory> - cd src/
<project>(e.g. cd src/Steeltoe.CloudFoundry.Connector) - dotnet restore
- dotnet pack --configuration
<Release or Debug>
The resulting artifacts can be found in the bin folder under the corresponding project. (e.g. src/Steeltoe.CloudFoundry.Connector\bin)
To run the unit tests:
- git clone ...
- cd
<clone directory> - cd test/
<test project>(e.g. cd test/Steeltoe.CloudFoundry.Connector.Test) - dotnet restore
- dotnet xunit -verbose
Building Packages & Running Tests - Linux/OSX
To build the packages on Linux/OSX: ( Note: Some connectors do not support CoreCLR.)
- git clone ...
- cd
<clone directory> - cd src/
<project>(e.g.. cd src/Steeltoe.CloudFoundry.Connector) - dotnet restore
- dotnet pack --configuration
<Release or Debug>
The resulting artifacts can be found in the bin folder under the corresponding project. (e.g. src/Steeltoe.CloudFoundry.Connector/bin
To run the unit tests: ( Note: Some connectors do not support CoreCLR.)
- git clone ...
- cd
<clone directory> - cd test/
<test project>(e.g. cd test/Steeltoe.CloudFoundry.Connector.Test) - dotnet restore
- dotnet xunit -verbose -framework netcoreapp2.0
Sample Applications
See the Samples repository for examples of how to use these packages.