Clean Architecture: Patterns, Practices, and Principles | Matthew Renze | Pluralsight

(open on draw.io)

(open on draw.io)

(open on draw.io)

(open on draw.io)

(open on draw.io)

(open on draw.io)

(open on draw.io)

(open on draw.io)

• Update Connection Strings:

  Project	Configuration File	Configuration Key
  ClassifiedAds.Migrator	appsettings.json	ConnectionStrings:ClassifiedAds
  ClassifiedAds.BackgroundServer	appsettings.json	ConnectionStrings:ClassifiedAds
  ClassifiedAds.GRPC	appsettings.json	ConnectionStrings:ClassifiedAds
  ClassifiedAds.IdentityServer	appsettings.json	ConnectionStrings:ClassifiedAds
  ClassifiedAds.NotificationServer	appsettings.json
  ClassifiedAds.WebAPI	appsettings.json	ConnectionStrings:ClassifiedAds
  ClassifiedAds.WebMVC	appsettings.json	ConnectionStrings:ClassifiedAds
  ClassifiedAds.GraphQL	appsettings.json	ConnectionStrings:ClassifiedAds
  ClassifiedAds.Ocelot	appsettings.json

• Run Migration:

  • Option 1: Using dotnet cli:
    • Install dotnet-ef cli:

      dotnet tool install --global dotnet-ef --version="3.1"
      

    • Navigate to ClassifiedAds.Migrator and run these commands:

      dotnet ef migrations add Init --context AdsDbContext -o Migrations/AdsDb
      dotnet ef migrations add Init --context ConfigurationDbContext -o Migrations/ConfigurationDb
      dotnet ef migrations add Init --context PersistedGrantDbContext -o Migrations/PersistedGrantDb
      dotnet ef database update --context AdsDbContext
      dotnet ef database update --context ConfigurationDbContext
      dotnet ef database update --context PersistedGrantDbContext
      

  • Option 2: Using Package Manager Console:
    • Set ClassifiedAds.Migrator as StartUp Project
    • Open Package Manager Console, select ClassifiedAds.Migrator as Default Project
    • Run these commands:

      Add-Migration -Context AdsDbContext Init -OutputDir Migrations/AdsDb
      Add-Migration -Context ConfigurationDbContext Init -OutputDir Migrations/ConfigurationDb
      Add-Migration -Context PersistedGrantDbContext Init -OutputDir Migrations/PersistedGrantDb
      Update-Database -Context AdsDbContext
      Update-Database -Context ConfigurationDbContext
      Update-Database -Context PersistedGrantDbContext
      

• Open ClassifiedAds.WebMVC/appsettings.json and jump to Storage section.

  "Storage": {
    "Provider": "Local",
  },

• Use Local Files:

  "Storage": {
    "Provider": "Local",
    "Local": {
      "Path": "E:\\files"
    },
  },

• Use Azure Blob:

  "Storage": {
    "Provider": "Azure",
    "Azure": {
      "ConnectionString": "xxx",
      "Container": "classifiedadds"
    },
  },

• Use Amazon S3:

  "Storage": {
    "Provider": "Amazon",
    "Amazon": {
      "AccessKeyID": "xxx",
      "SecretAccessKey": "xxx",
      "BucketName": "classifiedadds",
      "RegionEndpoint": "ap-southeast-1"
    }
  },

• Open ClassifiedAds.WebMVC/appsettings.json and jump to MessageBroker section.

  "MessageBroker": {
    "Provider": "RabbitMQ",
  }

• Use RabbitMQ

  "MessageBroker": {
    "Provider": "RabbitMQ",
    "RabbitMQ": {
      "HostName": "localhost",
      "UserName": "guest",
      "Password": "guest",
      "ExchangeName": "amq.direct",
      "RoutingKey_FileUploaded": "classifiedadds_fileuploaded",
      "RoutingKey_FileDeleted": "classifiedadds_filedeleted",
      "QueueName_FileUploaded": "classifiedadds_fileuploaded",
      "QueueName_FileDeleted": "classifiedadds_filedeleted"
    },
  }

• Use Kafka:

  "MessageBroker": {
    "Provider": "Kafka",
    "Kafka": {
      "BootstrapServers": "localhost:9092",
      "Topic_FileUploaded": "classifiedadds_fileuploaded",
      "Topic_FileDeleted": "classifiedadds_filedeleted"
    },
  }

• Use Azure Queue Storage:

  "MessageBroker": {
    "Provider": "AzureQueue",
    "AzureQueue": {
      "ConnectionString": "xxx",
      "QueueName_FileUploaded": "classifiedadds-fileuploaded",
      "QueueName_FileDeleted": "classifiedadds-filedeleted"
    },
  }

• Use Azure Service Bus:

  "MessageBroker": {
    "Provider": "AzureServiceBus",
    "AzureServiceBus": {
      "ConnectionString": "xxx",
      "QueueName_FileUploaded": "classifiedadds_fileuploaded",
      "QueueName_FileDeleted": "classifiedadds_filedeleted"
    }
  }

• Web MVC Home Page: https://localhost:44364/

  

• Navigate to Health Checks UI https://localhost:44364/healthchecks-ui#/healthchecks and make sure everything is green.

  

• Login on Identity Server:

  • Option 1: Use default created account:
    • User Name: [email protected]
    • Password: v*7Un8b4rcN@<-RN
  • Option 2: Register new account at https://localhost:44367/Account/Register

• Open Blazor Home Page at: https://localhost:44331

  

• Add Migrations if you haven't done on previous steps:

  • Install dotnet-ef cli:

    dotnet tool install --global dotnet-ef --version="3.1"
    

  • Navigate to ClassifiedAds.Migrator and run these commands:

    dotnet ef migrations add Init --context AdsDbContext -o Migrations/AdsDb
    dotnet ef migrations add Init --context ConfigurationDbContext -o Migrations/ConfigurationDb
    dotnet ef migrations add Init --context PersistedGrantDbContext -o Migrations/PersistedGrantDb
    

• Make sure Line Ending for these files is Unix (LF):

  Project	File
  ClassifiedAds.Migrator	docker-entrypoint.sh
  ClassifiedAds.BackgroundServer	docker-entrypoint.sh
  ClassifiedAds.WebMVC	docker-entrypoint.sh

  Otherwise you might encounter:

  exec user process caused "no such file or directory"
  

  Tip: Open Notepad++ -> Edit -> EOL Conversion -> Unix (LF)

• Navigate to ClassifiedAds.Projects and run:

  docker-compose build
  docker-compose up
  

• Open Web MVC Home Page at: http://host.docker.internal:9003

  

• Navigate to Health Checks UI http://host.docker.internal:9003/healthchecks-ui#/healthchecks and make sure everything is green.

  

• Login on Identity Server:

  • Use default created account: [email protected] / v*7Un8b4rcN@<-RN
  • Register new account at http://host.docker.internal:9000/Account/Register

• Open Blazor Home Page at: http://host.docker.internal:9008