GoodToCode Persistence for Azure and O365

GoodToCode Persistence for Azure and O365 is a cross-cutting (AOP) centric collection of projects that support common plumbing done in Azure Storage Tables, O365 Files, Azure CosmosDb and Azure SQL.

Pipeline: gtc-persistence-infrastructure

Pipeline: gtc-persistence-nuget

Prerequisites

You will need the following tools:

Setup

Follow these steps to get your development environment set up:

1. Setup your local ASPNETCORE_ENVIRONMENT setting

```

Application layer uses ASPNETCORE_ENVIRONMENT environment variable, and will default to Production if not found.
Add the ASPNETCORE_ENVIRONMENT entry in your Enviornment Variables

To accopmlish this on Windows
1. Open Control Panel > System > >Advanced Settings > Environment Variables > System Variables
2. Next add new User Variable UserVariables > New Variable name: ASPNETCORE_ENVIRONMENT Variable value: Development
3. Then Ok (to save)
You will need to restart Visual Studio, VS Code and Terminals to see the changes

2. Setup your Azure Storage Account and Azure Service Bus connection string in appsettings.*.json

- Application layer requires 1 Azure Storage Account and 1 Azure Service Bus cloud resource to operate.
- Both JSON configuration (appsettings.*.json) and Azure App Configuration service are supported
	
To accopmlish this in appsettings.*.json
1. Open all instances of appsettings.Development.json and appsettings.Production.json
2. Copy your Azure Storage Account and Azure CosmosDb Connection Strings from the Azure Portal
3. Paste your connection string over the following setting:
	"ConnectionStrings": {
		"CosmosDb": "AZURECOSMOSDB_CONNECTION_STRING",
		"StorageTables": "AZURESTORAGE_CONNECTION_STRING"
	}
4. Repeat for both Development and Production
5. Save all instances of appsettings.Development.json and appsettings.Production.json

Namespaces

GoodToCode.Persistence.Abstractions

Includes cross-platform interfaces and abstractions for use in all assemblies.

GoodToCode.Persistence.Blob

Includes all abstractions, classes and service collection extensions for Azure Blob Storage, Excel file reading/writing, and CSV reading/writing.

GoodToCode.Persistence.Azure

Includes all abstractions, classes and service collection extensions for Azure Storage Tables, CosmosDb, Entity Framework (EF) Core, etc.

goodtocode/persistence