Tutorial.NET untukAWS Cloud9

Tutorial ini memungkinkan Anda untuk menjalankan beberapa kode .NETAWS Cloud9lingkungan pengembangan.

Mengikuti tutorial ini dan membuat sampel ini dapat mengakibatkan biaya keAWSakun. Ini termasuk kemungkinan biaya untuk layanan seperti Amazon EC2 dan Amazon S3. Untuk informasi selengkapnya, lihat Harga Amazon EC2 dan Harga Amazon S3.

Prasyarat

Sebelum Anda menggunakan sampel ini, pastikan pengaturan Anda memenuhi persyaratan berikut:

• Anda harus memiliki yang adaAWS Cloud9Lingkungan pengembangan EC2. Contoh ini mengasumsikan bahwa Anda sudah memiliki lingkungan EC2 yang terhubung ke instans Amazon EC2 yang menjalankan Amazon Linux atauUbuntuPeladen. Jika Anda memiliki jenis lingkungan atau sistem operasi yang berbeda, Anda mungkin perlu menyesuaikan petunjuk sampel ini untuk menyiapkan alat terkait. Untuk informasi selengkapnya, lihat Membuat lingkungan di AWS Cloud9.

• Anda memilikiAWS Cloud9IDE untuk lingkungan yang ada sudah terbuka. Saat Anda membuka lingkungan, AWS Cloud9 membuka IDE untuk lingkungan itu di peramban web Anda. Untuk informasi selengkapnya, lihat Membuka lingkungan di AWS Cloud9.

Langkah 1: Pasang alat yang diperlukan

Pada langkah ini, Anda menginstal .NET SDK ke lingkungan Anda, yang diperlukan untuk menjalankan sampel ini.

1. Konfirmasikan apakah versi terbaru dari .NET SDK sudah diinstal di lingkungan Anda. Untuk melakukannya, dalam sesi terminal di AWS Cloud9 IDE, jalankan antarmuka baris perintah (CLI) .NET Core SDK dengan opsi --version .

   dotnet --version

   Jika versi Alat Baris Perintah .NET ditampilkan, dan versinya 2.0 atau lebih tinggi, langsung lanjutkan ke Langkah 3: Buat proyek aplikasi konsol.NET. Jika versi kurang dari 2.0, atau jika kesalahan sepertibash: dotnet: command not foundditampilkan, lanjutkan untuk menginstal .NET SDK.

2. Untuk Amazon Linux, dalam sesi terminal diAWS Cloud9IDE, jalankan perintah berikut untuk membantu memastikan pembaruan keamanan terbaru dan perbaikan bug diinstal, dan untuk menginstallibunwindpaket yang dibutuhkan .NET SDK. (Untuk memulai sesi terminal baru, pada bilah menu, pilih Jendela, Terminal Baru.)

   sudo yum -y update
   sudo yum -y install libunwind

   Untuk Server Ubuntu, dalam sesi terminal di AWS Cloud9 IDE, jalankan perintah berikut untuk membantu memastikan pembaruan keamanan terbaru dan perbaikan bug terpasang. (Untuk memulai sesi terminal baru, pada bilah menu, pilih Jendela, Terminal Baru.)

   sudo apt -y update

3. Unduh skrip installer.NET SDK ke lingkungan Anda dengan menjalankan perintah berikut.

   wget https://dot.net/v1/dotnet-install.sh

4. Jadikan skrip pemasangan dapat dieksekusi oleh pengguna saat ini dengan menjalankan perintah berikut.

   sudo chmod u=rx dotnet-install.sh

5. Jalankan skrip penginstal, yang mengunduh dan menginstal .NET SDK, dengan menjalankan perintah berikut.

   ./dotnet-install.sh -c Current

6. Tambahkan .NET SDK kePATH. Untuk melakukannya, di profil shell untuk lingkungan (misalnya, file .bashrc), tambahkan subdirektori $HOME/.dotnet ke variabel PATH untuk lingkungan, sebagai berikut.

   1. Buka file .bashrc untuk mengedit dengan menggunakan perintah vi .

      vi ~/.bashrc

   2. Untuk Amazon Linux, menggunakan tombol panah bawah atau j, pindah ke baris yang dimulai dengan export PATH.

      Untuk Server Ubuntu, pindah ke baris terakhir file dengan mengetik G.

   3. Menggunakan tombol panah kanan atau $, pindah ke akhir baris itu.

   4. Beralih ke mode penyisipan dengan menekan tombol i. (-- INSERT --- akan muncul di akhir tampilan.)

   5. Untuk Amazon Linux, tambahkan subdirektori $HOME/.dotnet ke variabel PATH dengan mengetik :$HOME/.dotnet. Pastikan untuk menyertakan karakter titik dua (:). Baris sekarang akan terlihat seperti berikut.

      export PATH=$PATH:$HOME/.local/bin:$HOME/bin:$HOME/.dotnet

      Untuk Server Ubuntu, tekan tombol panah kanan lalu tekan Enter dua kali, diikuti dengan mengetik baris berikut di akhir file sendiri.

      export PATH=$HOME/.dotnet:$PATH

   6. Simpan file tersebut. Untuk melakukannya, tekan tombol Esc (-- INSERT --- akan menghilang dari akhir tampilan), ketik :wq (untuk menulis ke dan kemudian keluar dari file), lalu tekan Enter.

7. Muat .NET SDK dengan mencari sumber.bashrcberkas.

   . ~/.bashrc

8. Konfirmasikan bahwa .NET SDK dimuat dengan menjalankan .NET CLI dengan --help pilihan.

   dotnet --help

   Jika berhasil, nomor versi.NET SDK ditampilkan, dengan informasi penggunaan tambahan.

9. Jika Anda tidak lagi ingin menyimpan skrip installer.NET SDK di lingkungan Anda, Anda dapat menghapusnya sebagai berikut.

   rm dotnet-install.sh

Langkah 2 (Opsional): Pasang ekstensi .NET CLI untuk fungsi Lambda

Meskipun tidak diperlukan untuk tutorial ini, Anda dapat menerapkanAWS Lambdafungsi danAWS Serverless Application Modelaplikasi yang menggunakan .NET CLI jika Anda juga menginstalAmazon.Lambda.Toolspaket.

1. Untuk memasang paket, jalankan perintah berikut:

   dotnet tool install -g Amazon.Lambda.Tools

2. Sekarang atur variabel lingkungan PATH dan DOTNET_ROOT untuk menunjuk ke alat Lambda yang terpasang. Di file .bashrc, temukan bagian export PATH dan edit sehingga tampak seperti berikut ini (lihat Langkah 1 untuk detail tentang mengedit file ini):

   export PATH=$PATH:$HOME/.local/bin:$HOME/bin:$HOME/.dotnet:$HOME/.dotnet/tools
   export DOTNET_ROOT=$HOME/.dotnet

Langkah 3: Buat proyek aplikasi konsol.NET

Pada langkah ini, Anda menggunakan .NET untuk membuat proyek bernamahello. Proyek ini berisi semua file yang dibutuhkan .NET untuk menjalankan aplikasi sederhana dari terminal di IDE. Kode aplikasi ditulis dalam C#.

Buat proyek aplikasi konsol.NET. Untuk melakukan ini, jalankan .NET CLI dengan new perintah, menentukan jenis template proyek aplikasi konsol dan bahasa pemrograman yang akan digunakan (dalam contoh ini, C #).

Opsi -n menunjukkan bahwa proyek dikeluarkan ke direktori baru, hello. Kami kemudian menavigasi ke direktori itu.

dotnet new console -lang C# -n hello
cd hello

Perintah sebelumnya menambahkan subdirektori dengan nama obj dengan beberapa file, dan beberapa file mandiri tambahan, ke direktori hello. Anda harus mencatat dua file kunci berikut:

• File hello/hello.csproj berisi informasi tentang proyek aplikasi konsol tersebut.

• File hello/Program.cs berisi kode aplikasi untuk dijalankan.

Langkah 4: Tambahkan kode

Pada langkah ini, Anda menambahkan beberapa kode ke aplikasi.

Dari jendela Lingkungan di AWS Cloud9 IDE, buka file hello/Program.cs.

Di editor, ganti konten file saat ini dengan kode berikut, lalu simpan file Program.cs.

using System;

namespace hello
{
  class Program
  {
    static void Main(string[] args)
    {
     if (args.Length < 2) {
       Console.WriteLine("Please provide 2 numbers");
       return;
     }

     Console.WriteLine("Hello, World!");

     Console.WriteLine("The sum of 2 and 3 is 5.");

     int sum = Int32.Parse(args[0]) + Int32.Parse(args[1]);

     Console.WriteLine("The sum of {0} and {1} is {2}.",
     args[0], args[1], sum);

    }
  }
}

Langkah 5: Bangun dan jalankan kode

Pada langkah ini, Anda membangun proyek dan dependensinya ke dalam kumpulan file biner, termasuk file aplikasi yang dapat dijalankan. Kemudian anda menjalankan aplikasi tersebut.

1. Dalam IDE, buat pembangun untuk.NET sebagai berikut.

   1. Pada bilah menu, pilih Jalankan, Bangun Sistem, Sistem Bangun Baru.

   2. Pada tab Builder.build Saya, ganti konten tab dengan kode berikut.

      {
        "cmd" : ["dotnet", "build"],
        "info" : "Building..."
      }

   3. Pilih File, Simpan Sebagai.

   4. Untuk Filename, ketik .NET.build.

   5. Untuk Folder, ketik /.c9/builders.

   6. Pilih Save (Simpan).

2. Dengan isiProgram.csfile yang ditampilkan di editor, pilihJalankan, Bangun Sistem, .NET. Kemudian pilih Jalankan, Bangun.

   Pembangun ini menambahkan subdirektori dengan nama bin dan menambahkan subdirektori dengan nama Debug ke subdirektori hello/obj. Perhatikan tiga file kunci berikut.

   • File hello/bin/Debug/netcoreapp3.1/hello.dll adalah file aplikasi yang dapat dijalankan.

   • File hello/bin/Debug/netcoreapp3.1/hello.deps.json mencantumkan dependensi aplikasi.

   • File hello/bin/Debug/netcoreapp3.1/hello.runtimeconfig.json menentukan waktu aktif bersama dan versinya untuk aplikasi.

   catatan

   Nama folder,netcoreapp3.1, mencerminkan versi SDK .NET yang digunakan dalam contoh ini. Anda mungkin melihat nomor yang berbeda dalam nama folder tergantung pada versi yang telah Anda pasang.

3. Buat runner untuk.NET sebagai berikut.

   1. Pada bilah menu, pilih Jalankan, Jalankan Dengan, Runner Baru.

   2. Pada tab My Runner.run, ganti isi tab dengan kode berikut.

      {
        "cmd" : ["dotnet", "run", "$args"],
        "working_dir": "$file_path",
        "info" : "Running..."
      }

   3. Pilih File, Simpan Sebagai.

   4. Untuk Filename, ketik .NET.run.

   5. Untuk Folder, ketik /.c9/runners.

   6. Pilih Save (Simpan).

4. Jalankan aplikasi dengan dua bilangan bulat untuk ditambahkan (misalnya, 5 dan 9) sebagai berikut.

   1. Dengan isi file Program.cs yang ditampilkan di editor, pilih Jalankan, Jalankan Konfigurasi, Jalankan Konfigurasi Baru.

   2. Di[Baru] - Menganggurtab, pilihPelari: Otomatis, dan kemudian pilih.NET.

   3. Di kotak Perintah, ketik hello 5 9.

   4. Memilih Jalankan.

      Secara default, runner ini menginstruksikan.NET untuk menjalankanhello.dllberkas dihello/bin/Debug/netcoreapp3.1direktori.

      Bandingkan output Anda dengan yang berikut ini.

      Hello, World!
      The sum of 2 and 3 is 5.
      The sum of 5 and 9 is 14.

Langkah 6: Buat dan siapkan proyek aplikasi konsol.NET yang menggunakanAWS SDK for .NET

Anda dapat meningkatkan sampel ini untuk menggunakan AWS SDK for .NET untuk membuat bucket Amazon S3, mencantumkan bucket yang tersedia, lalu menghapus bucket yang baru saja Anda buat.

Dalam proyek baru ini, Anda menambahkan referensi ke AWS SDK for .NET. AWS SDK for .NET menyediakan cara mudah untuk berinteraksi dengan layanan AWS seperti Amazon S3, dari kode .NET Anda. Anda kemudian mengatur pengelolaan kredensial AWS di lingkungan Anda. AWS SDK for .NET membutuhkan kredensial ini untuk berinteraksi dengan layanan AWS.

Untuk membuat proyek

1. Buat proyek aplikasi konsol.NET. Untuk melakukan ini, jalankan .NET CLI dengan new perintah, menentukan jenis template proyek aplikasi konsol dan bahasa pemrograman yang akan digunakan.

   Opsi -n menunjukkan bahwa proyek dikeluarkan ke direktori baru, s3. Kami kemudian menavigasi ke direktori itu.

   dotnet new console -lang C# -n s3
   cd s3

2. Tambahkan referensi proyek ke paket Amazon S3 di AWS SDK for .NET. Untuk melakukan ini, jalankan .NET CLI dengan add package perintah, menentukan nama paket Amazon S3 diNuGet. (NuGetmendefinisikan bagaimana paket untuk .NET dibuat, di-host, dan dikonsumsi, dan menyediakan alat untuk masing-masing peran tersebut.)

   dotnet add package AWSSDK.S3

   Saat Anda menambahkan referensi proyek ke paket Amazon S3,NuGetjuga menambahkan referensi proyek ke sisaAWS SDK for .NET.

   catatan

   Untuk nama dan versi lainnyaAWSpaket-paket terkait diNuGet, lihatNuGetpaket yang ditandai dengan aws-sdkpadaNuGetsitus web.

Untuk mengatur pengelolaan kredensial AWS

Setiap kali Anda menggunakan AWS SDK for .NET untuk memanggil layanan AWS, Anda harus memberikan satu set kredensial AWS dengan panggilan tersebut. Kredensial ini menentukan apakah AWS SDK for .NET memiliki izin yang sesuai untuk melakukan panggilan tersebut. Jika kredensial tidak mencakup izin yang sesuai, panggilan akan gagal.

Untuk menyimpan kredensial Anda di dalam lingkungan, ikuti petunjuk di MeneleponLayanan AWS dari lingkungan diAWS Cloud9, lalu kembali ke topik ini.

Untuk informasi tambahan, lihat Mengonfigurasi Kredensial AWS di Panduan Developer AWS SDK for .NET.

Langkah 7: Tambahkan kode AWS SDK

Pada langkah ini, Anda menambahkan kode untuk berinteraksi dengan Amazon S3 untuk membuat bucket, menghapus bucket yang baru saja Anda buat, lalu mencantumkan bucket yang tersedia.

Dari jendela Lingkungan di AWS Cloud9 IDE, buka file s3/Program.cs. Di editor, ganti konten file saat ini dengan kode berikut, lalu simpan file Program.cs.

using Amazon;
using Amazon.S3;
using Amazon.S3.Model;
using Amazon.S3.Util;
using System;
using System.Threading.Tasks;
     
namespace s3
{
  class Program
  {
   async static Task Main(string[] args)
   {
    if (args.Length < 2) {
      Console.WriteLine("Usage: <the bucket name> <the AWS Region to use>");
      Console.WriteLine("Example: my-test-bucket us-east-2");
      return;
    }
     
    if (args[1] != "us-east-2") {
      Console.WriteLine("Cannot continue. The only supported AWS Region ID is " +
      "'us-east-2'.");
       return;
     }
         
      var bucketRegion = RegionEndpoint.USEast2;
      // Note: You could add more valid AWS Regions above as needed.
     
      using (var s3Client = new AmazonS3Client(bucketRegion)) {
      var bucketName = args[0];
        
      // Create the bucket.
      try
      {
       if (await AmazonS3Util.DoesS3BucketExistV2Async(s3Client, bucketName))
       {
         Console.WriteLine("Cannot continue. Cannot create bucket. \n" +
         "A bucket named '{0}' already exists.", bucketName);
         return;
       } else {
         Console.WriteLine("\nCreating the bucket named '{0}'...", bucketName);
         await s3Client.PutBucketAsync(bucketName);
         }
       }
       catch (AmazonS3Exception e)
       {
        Console.WriteLine("Cannot continue. {0}", e.Message);
       }
       catch (Exception e)
       {
        Console.WriteLine("Cannot continue. {0}", e.Message);
       }
        
       // Confirm that the bucket was created.
       if (await AmazonS3Util.DoesS3BucketExistV2Async(s3Client, bucketName))
       {
          Console.WriteLine("Created the bucket named '{0}'.", bucketName);
       } else {
         Console.WriteLine("Did not create the bucket named '{0}'.", bucketName);
       }
        
       // Delete the bucket.
       Console.WriteLine("\nDeleting the bucket named '{0}'...", bucketName);
       await s3Client.DeleteBucketAsync(bucketName);
        
       // Confirm that the bucket was deleted.
       if (await AmazonS3Util.DoesS3BucketExistV2Async(s3Client, bucketName))
       {
          Console.WriteLine("Did not delete the bucket named '{0}'.", bucketName);
       } else {
         Console.WriteLine("Deleted the bucket named '{0}'.", bucketName);
       };
        
        // List current buckets.
       Console.WriteLine("\nMy buckets now are:");
       var response = await s3Client.ListBucketsAsync();
        
       foreach (var bucket in response.Buckets)
       {
       Console.WriteLine(bucket.BucketName);
       }
      }
    }
  }
}

Langkah 8: Bangun dan jalankan kode AWS SDK

Pada langkah ini, Anda membangun proyek dan dependensinya ke dalam kumpulan file biner, termasuk file aplikasi yang dapat dijalankan. Kemudian anda menjalankan aplikasi tersebut.

1. Bangun proyek. Untuk melakukan ini, dengan konten file s3/Program.cs yang ditampilkan di editor, pada bilah menu, pilih Jalankan, Bangun.

2. Jalankan aplikasi dengan nama bucket Amazon S3 yang akan dibuat dan ID Wilayah AWS untuk membuat bucket di (misalnya, my-test-bucket dan us-east-2) sebagai berikut.

   1. Dengan isi file s3/Program.cs yang masih ditampilkan di editor, pilih Jalankan, Jalankan Konfigurasi, Jalankan Konfigurasi Baru.

   2. Di[Baru] - Menganggurtab, pilihPelari: Otomatis, dan kemudian pilih.NET.

   3. Di kotak Perintah, ketik nama aplikasi, nama bucket Amazon S3 yang akan dibuat, dan ID Wilayah AWS untuk membuat bucket (misalnya, s3 my-test-bucket us-east-2).

   4. Memilih Jalankan.

      Secara default, runner ini menginstruksikan.NET untuk menjalankans3.dllberkas dis3/bin/Debug/netcoreapp3.1direktori.

      Bandingkan hasil Anda dengan output berikut.

      Creating a new bucket named 'my-test-bucket'...
      Created the bucket named 'my-test-bucket'.
      
      Deleting the bucket named 'my-test-bucket'...
      Deleted the bucket named 'my-test-bucket'.
      
      My buckets now are:

Langkah 9: Bersihkan

Untuk mencegah tagihan berkelanjutan ke akun AWS Anda setelah selesai menggunakan sampel ini, Anda harus menghapus lingkungan. Untuk instruksi, lihat Menghapus lingkungan di AWS Cloud9.