Tutorial.NET untuk AWS Cloud9

Tutorial ini memungkinkan Anda untuk menjalankan beberapa kode .NET di lingkungan AWS Cloud9 pengembangan.

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

Prasyarat

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

• Anda harus memiliki lingkungan AWS Cloud9 EC2 pengembangan yang ada. Contoh ini mengasumsikan bahwa Anda sudah memiliki EC2 lingkungan yang terhubung ke EC2 instans Amazon yang menjalankan Amazon Linux atau Ubuntu Peladen. 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 Menciptakan lingkungan di AWS Cloud9.

• Anda memiliki AWS Cloud9 IDE untuk lingkungan yang ada sudah terbuka. Saat Anda membuka lingkungan, AWS Cloud9 buka IDE untuk lingkungan itu di browser 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 melakukan ini, dalam sesi terminal di AWS Cloud9 IDE, jalankan antarmuka baris perintah .NET Core (CLI) 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 seperti bash: dotnet: command not found ditampilkan, lanjutkan untuk menginstal .NET SDK.

2. Untuk Amazon Linux, dalam sesi terminal di AWS Cloud9 IDE, jalankan perintah berikut untuk membantu memastikan pembaruan keamanan terbaru dan perbaikan bug diinstal, dan untuk menginstal libunwind paket 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 Ubuntu Server, dalam sesi terminal di AWS Cloud9 IDE, jalankan perintah berikut untuk membantu memastikan pembaruan keamanan terbaru dan perbaikan bug diinstal. (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 ke file AndaPATH. 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 sumber .bashrc file.

   . ~/.bashrc

8. Konfirmasikan .NET SDK dimuat dengan menjalankan .NET CLI dengan --helpopsi.

   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 menyebarkan AWS Lambda fungsi dan AWS Serverless Application Model aplikasi menggunakan CLI .NET jika Anda juga menginstal Amazon.Lambda.Tools paket.

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 CLI .NET dengan newperintah, tentukan 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 hello/Program.cs file.

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 Simpan.

2. Dengan isi Program.cs file yang ditampilkan di editor, pilih Jalankan, 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 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 tab [Baru] - Idle, pilih Runner: Auto, lalu pilih .NET.

   3. Di kotak Perintah, ketik hello 5 9.

   4. Pilih Jalankan.

      Secara default, runner ini menginstruksikan.NET untuk menjalankan hello.dll file di direktori. hello/bin/Debug/netcoreapp3.1

      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 menggunakan AWS SDK untuk .NET

Anda dapat menyempurnakan sampel ini AWS SDK untuk .NET untuk menggunakan 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 untuk .NET. AWS SDK untuk .NET Ini menyediakan cara mudah untuk berinteraksi dengan AWS layanan seperti Amazon S3, dari kode .NET Anda. Anda kemudian mengatur manajemen AWS kredensyal di lingkungan Anda. AWS SDK untuk .NET Kebutuhan kredensyal ini untuk berinteraksi dengan AWS layanan.

Untuk membuat proyek

1. Buat proyek aplikasi konsol.NET. Untuk melakukan ini, jalankan CLI .NET dengan newperintah, tentukan 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 untuk .NET. Untuk melakukan ini, jalankan .NET CLI dengan add packageperintah, tentukan nama paket Amazon S3 di. NuGet (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, tambahkan NuGet juga referensi proyek ke paket lainnya. AWS SDK untuk .NET

   catatan

   Untuk nama dan versi paket AWS terkait lainnya NuGet, lihat NuGetpaket yang ditandai dengan aws-sdk di situs web. NuGet

Untuk mengatur manajemen AWS kredensial

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

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

Untuk informasi selengkapnya, lihat Mengonfigurasi AWS Kredensyal di Panduan Pengembang.AWS SDK untuk .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 s3/Program.cs file. 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 tab [Baru] - Idle, pilih Runner: Auto, lalu pilih .NET.

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

   4. Pilih Jalankan.

      Secara default, runner ini menginstruksikan.NET untuk menjalankan s3.dll file di direktori. s3/bin/Debug/netcoreapp3.1

      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: Membersihkan

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