Get started with .NET development on Amazon Web Services

by Jeff Yoder | on

This post explains 3 important areas to set up in order to begin your journey with .NET development on Amazon Web Services. First, create an Amazon Web Services account and configure a developer user with an appropriate level of access. Second, install and configure command line tools. Lastly, download and configure the toolkit for your IDE. Many of the tools assume minimal knowledge of Amazon Web Services and will guide you.

Setting up and Configuring your Amazon account

To begin creating a new account follow the steps in the knowledge center article titled: How do I create and activate a new Amazon Web Services account? After your account is successfully created we recommend taking some time now or in the future to review the Amazon Web Services Free Tier . The free tier enables you to explore hundreds of products and easily start your journey building on Amazon Web Services. Also, consider setting up billing alerts so you are not surprised by unexpected charges.

When you log in for the first time the Amazon Web Services Management Console displays default widgets for a number of criteria. At this stage you can review the introductory material in the Welcome to Amazon Web Services widget or jump into configuring the console and your account.

AWS Console Home displaying default widgets.

Management Console and Security Configuration Steps

Select your region

It’s important to choose and confirm your Amazon Web Services Region when you visit the console. Amazon Web Services global infrastructure is grouped into regions and each service is hosted in a Region. You should change the region to the location closest to your physical location. For example, if you live in the northeast United States select us-east-1 and not us-west-2.

Region selector dropdown displaying available regions

Create a developer user

The first time you access the console you will be signed in as an administrator. Administrator access is a powerful level of access that is not appropriate for all users and use cases. To ensure that your level of access is appropriate you can create a new user in your account and apply specific permissions to that user.

  1. To create a new user in your account, use the Identity and Access Management (IAM) service, enter IAM in the search box and select IAM from the list of services.
    Services dropdown displaying search results for IAM.
  2. In IAM select Users, and then select Add users.
    Identity Access Management window adding a new user
  3. In Specify user details enter the name of a new user in Username, and then select Next.
    Window with a search box to use when specifying user details.
  4. In Set permissions select Attach policies directly, in the search box enter PowerUserAccess, and then select the appropriate checkbox and choose Next. As you work with different services you will need to add additional permissions which you can find on the service product pages .
    Note: A user with the PowerUserAccess permission performs application development tasks and can create and configure resources and services that support Amazon Web Services application development. Remember to follow your organization’s security best practices and follow Amazon Web Services least privilege guidelines.
    Window displaying search results when setting permissions.
  5. In Review and create review the User details and Permissions summary, then choose Create User.
    A window where you can review the user details entered and create a user.

Create and download credentials

Now that you’ve created a new user you can configure the user to have a programmatic access key and secret key. These credentials will enable the Amazon Web Services CLI and other tools to access your Amazon Web Services account.

  1. Navigate to IAM, select Users, then in the Users panel select the User name for the user you recently created.
  2. In the user window select the Security credentials tab, then select Create access key.
    IAM window, click create access key to create the key for your user.
  3. In Access key best practices & alternatives select Command Line Interface (CLI), select that you understand the alternative recommendations, then select Next.
    Window used to select access key best practices.
  4. In Set description tag enter an option description that details the purpose of the access keys then select Create access key. The access key and secret access keys are created.
  5. Select Download .csv file and save the file in secure location. You must save these keys in a safe place for future use.

Install and configure command line tools

When utilizing the command line, we recommend the Amazon Web Services Command Line Interface (Amazon Web Services CLI) which is a unified tool to manage your Amazon Web Services services. The CLI is an open-source tool that enables you to interact with Amazon Web Services services using commands in your command-line shell. If you prefer PowerShell, you can use Amazon Web Services Tools for PowerShell.

We also recommend you install extensions to the dotnet commands for Amazon Web Services and install the Amazon Web Services .NET deployment tool for .NET CLI.

Follow the steps listed below to install and configure the command line tools

  1. Install the Amazon Web Services CLI .
  2. Configure the Amazon Web Services CLI and link it to your Amazon Web Services account and user with the credentials you downloaded. This creates a default Amazon Web Services profile.
    Command line window displaying AWS configure commands
  3. Install the Amazon Web Services Extensions for .NET CLI . These tool extensions are focused on building dotnet (formerly .NET Core) and ASP.NET Core applications and deploying them to Amazon Web Services services
  4. Install the Amazon Web Services.NET deployment tool for .NET CLI . This tool simplifies deployment of .NET applications by suggesting compatible Amazon Web Services compute services for your application.
  5. If you’re a PowerShell user install the Amazon Web Services Tools for PowerShell .

Install and Configure Amazon Web Services IDE Toolkits

Amazon Web Services offers several IDE toolkits that can be used to develop, debug, and deploy to Amazon Web Services products. The below steps are specific for Microsoft Visual Studio users. To see a full list of other toolkits, review the Amazon Web Services IDE Toolkits section of the Tools page on the .NET on Amazon Web Services Developer Center.

  1. Install the Amazon Web Services Toolkit for Visual Studio . This toolkit improves development workflows by making Amazon Web Services services available directly from your Visual Studio environment. This toolkit also includes the feature Publish to Amazon Web Services which guides you in the publishing process.
  2. In Visual Studio go to the Amazon Web Services Explorer view and select default as your Amazon Web Services profile. When default is selected a list of Amazon Web Services services are displayed in the Amazon Web Services Explorer. You should then set the region in Amazon Web Services Explorer to match the region in the Amazon Web Services Management Console.

Conclusion

In this post, we showed you how to get setup with an Amazon Web Services account, create a new user, and create and download credentials. We then outlined how to install and configure important command line tools and IDE toolkits. For more information on all things .NET on Amazon Web Services bookmark the .NET on Amazon Web Services developer center website and follow this blog and read our future posts. We encourage you to share your experience with .NET on Amazon Web Services by reaching out to us at mailto:dotnet-on-aws-feedback@amazon.com .