. NETtutorial untuk AWS Cloud9 - AWS Cloud9

AWS Cloud9 tidak lagi tersedia untuk pelanggan baru. Pelanggan yang sudah ada AWS Cloud9 dapat terus menggunakan layanan seperti biasa. Pelajari selengkapnya

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

. NETtutorial untuk AWS Cloud9

Tutorial ini memungkinkan Anda untuk menjalankan beberapa. NETkode dalam 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 EC2Harga 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 Server. 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. Ketika 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 file. NETSDKke lingkungan Anda, yang diperlukan untuk menjalankan sampel ini.

  1. Konfirmasikan apakah versi terbaru dari. NETSDKsudah terpasang di lingkungan Anda. Untuk melakukan ini, dalam sesi terminal di AWS Cloud9 IDE, jalankan file. NETAntarmuka baris perintah inti (CLI) dengan --versionopsi.

    dotnet --version

    Jika. NETVersi Command Line Tools ditampilkan, dan versinya 2.0 atau lebih besar, lompat ke depanLangkah 3: Buat. NETproyek aplikasi konsol. Jika versi kurang dari 2.0, atau jika kesalahan seperti bash: dotnet: command not found ditampilkan, lanjutkan untuk menginstal. NETSDK.

  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. NETSDKkebutuhan. (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. NETSDKskrip installer 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 file. NETSDK, dengan menjalankan perintah berikut.

    ./dotnet-install.sh -c Current
  6. Tambahkan. NETSDKuntuk 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. Memuat. NETSDKdengan sumber .bashrc file.

    . ~/.bashrc
  8. Konfirmasikan. NETSDKdimuat dengan menjalankan. NETCLIdengan --helpopsi.

    dotnet --help

    Jika berhasil, NETSDKnomor versi ditampilkan, dengan informasi penggunaan tambahan.

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

    rm dotnet-install.sh

Langkah 2 (Opsional): Instal. NETCLIekstensi untuk fungsi Lambda

Meskipun tidak diperlukan untuk tutorial ini, Anda dapat menerapkan AWS Lambda fungsi dan AWS Serverless Application Model aplikasi menggunakan. NETCLIjika 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. NETproyek aplikasi konsol

Pada langkah ini, Anda menggunakan. NETuntuk membuat proyek bernamahello. Proyek ini berisi semua file itu. NETperlu menjalankan aplikasi sederhana dari terminal diIDE. Kode aplikasi ditulis dalam C#.

Buat a. NETproyek aplikasi konsol. Untuk melakukan ini, jalankan. NETCLIdengan newperintah, 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 Environment 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. DiIDE, buat pembangun untuk. NETsebagai 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 file. NETSDKdigunakan dalam contoh ini. Anda mungkin melihat nomor yang berbeda dalam nama folder tergantung pada versi yang telah Anda pasang.

  3. Buat pelari untuk. NETsebagai 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, pelari ini menginstruksikan. NETuntuk menjalankan hello.dll file di hello/bin/Debug/netcoreapp3.1 direktori.

      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 atur file. NETproyek aplikasi konsol yang menggunakan AWS SDK for .NET

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

Untuk membuat proyek

  1. Buat a. NETproyek aplikasi konsol. Untuk melakukan ini, jalankan. NETCLIdengan newperintah, 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. NETCLIdengan add packageperintah, menentukan nama paket Amazon S3 di. NuGet (NuGetmendefinisikan bagaimana paket untuk. NETdibuat, dihosting, 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 for .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 for .NET untuk memanggil AWS layanan, Anda harus memberikan satu set AWS kredensyal dengan panggilan tersebut. Kredensyal ini menentukan apakah AWS SDK for .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 for .NET

Langkah 7: Tambahkan AWS SDK kode

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 Environment 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 AWS SDK 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. 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, pelari ini menginstruksikan. NETuntuk menjalankan s3.dll file di s3/bin/Debug/netcoreapp3.1 direktori.

      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.