/Minio.ServiceFabric

Minio for Service Fabric - an open source & high performance distributed object storage server with Amazon S3 compatible API

Primary LanguagePowerShell

Service Fabric Minio

Minio for Service Fabric is an open source object storage server with Amazon S3 compatible API.

Benefits of running Minio in Service Fabric

  • High availability. Service Fabric ensures that instances of Minio are running.
  • Health monitoring. Service Fabric health monitoring detects if Minio is running, and provides diagnostic information if there is a failure.
  • Application lifecycle management. Besides providing upgrades with no downtime, Service Fabric provides automatic rollback to the previous version if there is a bad health event reported during an upgrade.
  • Density. You can run multiple Minio instances in a cluster, which eliminates the need for each application to run on its own hardware.
  • Discoverability: Using REST you can call the Service Fabric Naming service to find instances of Minio in the cluster.

Minio Pluggable Storage Backend

Minio supports filesystem and erasure code backends for DAS and JBODs, external storage backends such as NAS, Google Cloud Storage, and Azure Blob Storage via configuration only changes.

Getting started - Installing Minio for Service Fabric

Open your existing Service Fabric solution in Visual Studio 2017, then in Solution Explorer right-click on the solution node and select the Manage Nuget Packages for Solution menu. Search for the Minio.ServiceFabric package, make sure to check the master Service Fabric application project and click the Install button. After the installation completes, in the ApplicationPackageRoot there will be a new Minio.ServiceFabricPkg folder.

Minio for Service Fabric can also be installed via the Package Manager Console:

Install-Package Minio.ServiceFabric

Before you publish to Service Fabric though, make sure to check the ApplicationManifest.xml file. The InstanceCount should be set to -1 (SingletonPartition).

Configure Service Fabric Minio

Open the ServiceManifest.xml file found in Minio.ServiceFabricPkg folder and in the EntryPoint section elect to run Minio in either Gateway or Server mode.

Two example bat files are provide as guidance:

  • minio_gateway_azure.bat - Minio acts as a gateway server and forwards data to Azure Blob Storage
  • minio_server.bat - Minio will save data to the local file-system of the Node hosting the minio.exe process or as per minio configuration

Minio.ServiceFabricPkg\Code folder

If running Minio as a gateway to Azure Blob Storage, don't forget to set the MINIO_ACCESS_KEY (AccountName) and MINIO_SECRET_KEY (AccountKey) corresponding to your Azure Blob Storage account.

The Minio.ServiceFabric project is packaged using Microsoft's SFNuGet, which allows you to package and share Azure Service Fabric services as NuGet packages. For more info head over to SFNuGet.