Memealyzer determines if a meme's sentiment is positive, negative, or neutral.

For example, given this meme:

Memealyzer will extract the text, analyize the sentiment of that text, and then change the border color to red for negative sentiment, green for positive, and yellow for neutral.

Memealyzer is an app built to demonstrate some the latest and greatest Azure tech to dev, debug, and deploy microservice applications, including:

• Azure SDKs - to interact Azure services
• Bicep & Azure CLI - to provision Azure resources
• Project Tye to dev, debug, and deploy the solution
• Blazor - for a responsive client-side app built with .NET/C#.
• Azure Functions - to connect message queues with SignalR
• Azure SignalR Service - to send messages to the web app

Since 12/5/2020, this project will use Bicep and Project Tye instead of Terraform and Docker Compose, so we will not keep those files up to date. They will be kept in the project for historical purposes only. More info can be found on the "Legacy Tools" page

This is the current .NET architecture - we are in the process of developing for other languages and architectures as well.

The following Azure resources are used in this application:

1. Resource Group
2. Storage Account
3. Cognitive Services Form Recognizer
4. Cognitive Services Text Analytics
5. Cosmos DB
6. Key Vault
7. Azure Kubernetes Service
8. Application Insights
9. Azure SignalR Service
10. Azure Functions
11. Azure Service Bus

You can select the Data and Messaging Providers via environment variables. See the "Environment Variables" section below for more information.

The following are required to run this application.

1. Terminal - WSL2, Zsh, GitBash, PowerShell, not Windows Command prompt as this application uses bash script files.
2. Azure CLI
3. Git
4. VS Code
5. Docker
6. Kubectl
7. .NET SDK - 5.0
8. Azure Functions Core Tools - v3.0.2881 minimum
9. Project Tye
10. Bicep

Please note that you will see {BASENAME} throughout this document. Replace it with any unique text that you'd like, such as memealyzer007.

Here's how to quickly provision and deploy the app:

1. Open a Terminal - The same terminal you used to install the pre-reqs above.
2. Clone Repo
   • git clone https://github.com/jongio/memealyzer
3. Make sure you follow the "Dev Machine Setup" steps above.
4. You can open the entire VS Code workspace here

   • ./open.sh

     or

   • Open /src/net/memealyzer.code-workspace

5. Login to the Azure CLI and set your subscription
   • az login and az account set -s {SUBSCRIPTION_NAME}
6. To deploy all required Azure Resources and run locally:
   • ./run.sh {BASENAME}
7. To deploy all required Azure Resources and run in Azure:
   • ./deploy.sh {BASENAME}

To only deploy resources:

1. Provision Azure Resources with Bicep:
   1. CD to iac\bicep
   2. Run ./deploy.sh {BASENAME}

To run the app locally:

1. Run Application with Project Tye:
   1. CD to pac\net\tye
   2. Run ./run.sh {BASENAME}
   3. Open http://localhost:1080
   4. Click (single) or ∞ (stream) buttons to analyze memes.
   5. Enjoy the memes and the sentiment analysis.

To run the app in Azure:

1. Deploy Application to Azure with Project Tye:
   1. CD to pac\net\tye
   2. Run ./deploy.sh {BASENAME}
   3. Click on the IP ADDRESS that is outputted to the console to load Memealyzer.

You can configure which store the app uses to persist your image metadata, either Cosmos DB or Azure Table Storage.

1. Open .env file
2. Find or add the AZURE_STORAGE_TYPE setting
3. Set it to one of the following values:
   • COSMOS_SQL - This will instruct the app to use Cosmos DB.
   • STORAGE_TABLE - This will instruct the app to use Azure Storage Tables.

You can configure which messaging service you want to use, either Service Bus Queue or Azure Storage Queue.

1. Open .env file
2. Find or add the AZURE_MESSAGING_TYPE setting
3. Set it to one of the following values:
   • SERVICE_BUS_QUEUE - This will instruct the app to use Service Bus Queue.
   • STORAGE_QUEUE - This will instruct the app to use Azure Storage Queue.

You can configure the image border style with the Azure App Configuration service. It will default to solid, but you can change it to any valid CSS border style. You can either do this in the Azure Portal, or via the Azure CLI with this command:

az appconfig kv set -y -n {BASENAME}appconfig --key borderStyle --value dashed

After you change the setting, reload the WebApp to see the new style take effect.

You can add override any of the following environment variables to suit your needs. Memealyzer chooses smart defaults that match what is created when you deploy the app with Terraform.