A dynamic microservices framework for building, connecting, and deploying cloud-native applications.

---

---

ASP.net Core Starter Project

This project is an example application written in ASP.net with a Postgres database backend packaged into an Architect component.

This starter application will show how easy it is to deploy an application both locally and in a remote environment.

Pre-reqs

• Install Docker and make sure it's running
• Install the Architect CLI
• Sign up for a free Architect account

Clone the repo

To use this project, you can clone this repo yourself or use the architect init command.

Use architect init

You can use the architect init command to clone this repo locally. A drop-down list of Starter Projects is displayed for you to select from.

$ architect init
? What is the name of your project? my-starter-project
? Please select a framework/language for your project asp-net-core

######################################
##### Let's set up your project! #####
######################################

Creating project directory... ✓
Pulling down GitHub repository... ✓ asp-net-core

Successfully created project my-starter-project.

Your project is ready to be deployed by Architect!
To deploy locally, run:
	architect dev my-starter-project/architect.yml

$ cd ./my-starter-project

Clone it yourself

Run the following command to clone the repo yourself:

# Clone the repository and navigate to this directory
$ git clone [email protected]:architect-templates/asp-net-core.git
$ cd ./asp-net-core

Run Locally

Once the repo has been cloned to your local machine, execute the following command from the asp-net-core directory to run it locally:

$ architect dev .

When this command completes, you can reach your new application by going to https://app.localhost.architect.sh.

Make your own changes

This application's architect.yml file contains a debug block that enables hot-reloading for each service within the component. That means you can make changes to the source code and those changes will be applied to the environment automatically. This allows you to quickly iterate and see your changes without having to restart the application stack.

Give it a try! Search inside your project for “Favorite Movie” and change this string to "Favorite Pizza" Once you save the file, you’ll see the frontend service recompiling in the logs and then your browser window will update automatically.

Deploy to the Cloud

Want to try deploying this application to a cloud environment? Architect's got you covered there, too! We offer free preview environments in our community cloud where you can deploy your applications before deploying to staging or prod. This is a great opportunity for testing and getting early feedback before merging your code. In fact, you can configure your GitOps to automatically deploy every PR to Architect's community cloud.

Create an environment

To create a new environment on Architect's free cloud, run the following command:

$ architect environments:create my-first-environment

This command presents you with a list of Kubernetes clusters. Since you haven't added any external clusters to your account, you should only see architect. Hit enter to create your environment on Architect's community cloud.

? Select a cluster (Use arrow keys or type to search)
❯  architect

When the command completes, you should see output similar to the following:

$ architect environments:create my-first-environment
? Select a cluster architect
Registering environment with Architect... done
Environment created: https://cloud.architect.io/<account-name>/environments/my-first-environment

Deploy your component

You are now ready to deploy your component to your environment in Architect's community cloud. To deploy your component, run the following command from the asp-net-core directory:

$ architect deploy --account <account-name> --environment my-first-environment ./architect.yml

Congrats! You've deployed your first component using Architect.