Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

aligncenter

...

Prerequisites

  1. .Net Core SDK

  2. .Net IDE of choice

  3. Access to the SkySync SDK packages

  4. SkySync SDK custom project template

  5. Basic understanding of creating a SkySync Platform extension

Getting Started

The SkySync Platform allows users to connect to on-premise and cloud storage platforms and orchestrate the content contained within those platforms. In order to orchestrate the content, SkySync first needs to be able to talk to the storage platforms

...

on both the source and the destination. This is accomplished by providing an implementation of an IConnectorProvider interface. SkySync provides supported implementations for a number of storage platforms out of the box. However, when a customer has a platform that we do not support out of the box, then a custom connector must be provided that acts as the bridge between the native storage platform APIs and SkySync

Creating a Custom Connector

In the previous tutorial, we created a basic platform extension. We also mentioned some additional parameters that can be used to customize the project that is generated by the template. One of those parameters is --extension. It can be used to specify the exact type of extension that you would like to create. One of the available options is --extension=connector that customizes the project as a custom connector:

Code Block
languagebash
dotnet new skysynclib --name MyCustomConnector --extension connector

Just as we had to do in the previous tutorial, we need to create a solution and add our new projects to it.

Code Block
languagebash
cd MyCustomConnector
dotnet new solution
dotnet sln add src\MyCustomConnector\MyCustomConnector.csproj
dotnet sln add test\MyCustomConnector.Tests\MyCustomConnector.Tests.csproj

...

bgColor#FFFACD
borderWidth2
titleCAUTION

(info)   This area of the documentation is a work-in-progress

...

Deployment

During development of this custom connector, it is recommended to just build the project using dotnet build, which will build using the Debug configuration as well as copy the connector into the appropriate directory on your machine for SkySync to pick it up if you have a local copy that you can use to test live within the product. However, once you are ready to deploy this connector to customers then you will want to package it as a NuGet package (.nupkg file) using dotnet pack --configuration Release and deploy it to a SkySync instance.