Connectors simplify connecting to standalone and CloudFoundry services
Перейти к файлу
Spring Operator 6abe662fdb URL Cleanup (#39)
This commit updates URLs to prefer the https protocol. Redirects are not followed to avoid accidentally expanding intentionally shortened URLs (i.e. if using a URL shortener).

# Fixed URLs

## Fixed Success
These URLs were switched to an https URL with a 2xx status. While the status was successful, your review is still recommended.

* [ ] http://www.apache.org/licenses/ with 2 occurrences migrated to:
  https://www.apache.org/licenses/ ([https](https://www.apache.org/licenses/) result 200).
* [ ] http://www.apache.org/licenses/LICENSE-2.0 with 179 occurrences migrated to:
  https://www.apache.org/licenses/LICENSE-2.0 ([https](https://www.apache.org/licenses/LICENSE-2.0) result 200).
2019-03-26 16:40:30 -05:00
config Create update111 branch 2017-09-22 10:53:52 -06:00
scripts Create update111 branch 2017-09-22 10:53:52 -06:00
src URL Cleanup (#39) 2019-03-26 16:40:30 -05:00
test URL Cleanup (#39) 2019-03-26 16:40:30 -05:00
.gitattributes Initial checkin 2016-06-28 10:14:02 -06:00
.gitignore Changes for move to .csproj 2017-04-20 10:18:30 -06:00
.travis.yml Changes for update builds 2017-09-22 10:44:54 -06:00
CONTRIBUTING.md Create CONTRIBUTING.md 2017-09-15 14:40:47 -04:00
Connectors.sln Add Hystrix connector 2017-06-01 10:44:00 -06:00
License.txt URL Cleanup (#39) 2019-03-26 16:40:30 -05:00
README.md Update readme 2017-06-06 09:36:30 -06:00
appveyor.yml Create update111 branch 2017-09-22 10:53:52 -06:00
nuget.config Fix default nuget.config 2017-06-21 09:20:46 -06:00
open_source_licenses.txt URL Cleanup (#39) 2019-03-26 16:40:30 -05:00
versions.props Update default version file 2017-06-21 12:12:52 -06:00

README.md

.NET CloudFoundry Connectors

This repo contains several connectors which simplify the process of connecting to services on CloudFoundry.

Windows Master (Stable): AppVeyor Master

Windows Dev (Less Stable): AppVeyor Dev

Linux/OS X Master (Stable): Travis Master

Linux/OS X Dev (Less Stable): Travis Dev

.NET Runtime & Framework Support

Like ASP.NET Core, the connectors are intended to support both .NET 4.5.1+ and .NET Core (CoreCLR/CoreFX) runtimes. Note that some connectors only support .NET 4.5.1+ since the libraries they depend on do not yet 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 1.1, .NET 4.5.1/4.6.x, and on ASP.NET Core 1.1.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.

Development feed (Less Stable) - https://www.myget.org/gallery/steeltoedev

Master feed (Stable) - https://www.myget.org/gallery/steeltoemaster

Release or Release Candidate feed - https://www.nuget.org/.

Building Pre-requisites

To build and run the unit tests:

  1. .NET Core SDK 1.0.4 or greater
  2. .NET Core Runtime 1.1

Building Packages & Running Tests - Windows

To build the packages on windows:

  1. git clone ...
  2. cd <clone directory>
  3. Install .NET Core SDK
  4. dotnet restore --configfile nuget.config src
  5. cd src\ <project> (e.g. cd src\Steeltoe.CloudFoundry.Connector)
  6. 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:

  1. git clone ...
  2. cd <clone directory>
  3. Install .NET Core SDK
  4. dotnet restore --configfile nuget.config test
  5. cd test\ <test project> (e.g. cd test\Steeltoe.CloudFoundry.Connector.Test)
  6. dotnet xunit -verbose

Building Packages & Running Tests - Linux/OSX

To build the packages on Linux/OSX: ( Note: Some connectors do not support CoreCLR.)

  1. git clone ...
  2. cd <clone directory>
  3. Install .NET Core SDK
  4. dotnet restore --configfile nuget.config src
  5. cd src/ <project> (e.g.. cd src/Steeltoe.CloudFoundry.Connector)
  6. 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.)

  1. git clone ...
  2. cd <clone directory>
  3. Install .NET Core SDK
  4. dotnet restore --configfile nuget.config test
  5. cd test\ <test project> (e.g. cd test/Steeltoe.CloudFoundry.Connector.Test)
  6. dotnet xunit -verbose -framework netcoreapp1.1

Sample Applications

See the Samples repo for examples of how to use these packages.