Tutorial: Jalankan end-to-end tes menggunakan Greengrass Testing Framework dan Greengrass Development Kit - AWS IoT Greengrass
PrasyaratLangkah 1: Inisialisasi proyek GDK dengan komponenLangkah 2: Inisialisasi proyek GDK dengan modul uji end-to-endLangkah 3: Bangun kasus uji khususLangkah 4: Tambahkan tag ke kasus uji baruLangkah 5: Bangun JAR tesLangkah 6: Jalankan tesContoh: Membangun kasus uji khusus

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

Tutorial: Jalankan end-to-end tes menggunakan Greengrass Testing Framework dan Greengrass Development Kit

AWS IoT GreengrassTesting Framework (GTF) dan Greengrass Development Kit (GDK) menawarkan pengembang cara untuk menjalankan pengujian. end-to-end Anda dapat menyelesaikan tutorial ini untuk menginisialisasi proyek GDK dengan komponen, menginisialisasi proyek GDK dengan modul end-to-end pengujian, dan membangun kasus uji khusus. Setelah Anda membangun kasus uji kustom Anda, Anda kemudian dapat menjalankan pengujian.

Dalam tutorial ini, Anda melakukan hal-hal berikut:

  1. Inisialisasi proyek GDK dengan komponen.

  2. Inisialisasi proyek GDK dengan modul end-to-end uji.

  3. Buat kasus uji khusus.

  4. Tambahkan tag ke kasus uji baru.

  5. Bangun JAR tes.

  6. Jalankan tes.

Prasyarat

Untuk menyelesaikan tutorial ini, Anda memerlukan hal berikut:

  • GDK versi 1.3.0 atau yang lebih baru

  • Java

  • Maven

  • Git

Langkah 1: Inisialisasi proyek GDK dengan komponen

  • Inisialisasi folder kosong dengan proyek GDK. Unduh HelloWorld komponen yang diimplementasikan dengan Python dengan menjalankan perintah berikut.

    gdk component init -t HelloWorld -l python -n HelloWorld

    Perintah ini membuat direktori baru bernama HelloWorld dalam direktori saat ini.

Langkah 2: Inisialisasi proyek GDK dengan modul uji end-to-end

  • GDK memungkinkan Anda mengunduh templat modul pengujian yang terdiri dari implementasi fitur dan langkah. Jalankan perintah berikut untuk membuka HelloWorld direktori dan menginisialisasi proyek GDK yang ada menggunakan modul pengujian.

    cd HelloWorld
gdk test-e2e init

    Perintah ini membuat direktori baru bernama gg-e2e-tests dalam HelloWorld direktori. Direktori pengujian ini adalah proyek Maven yang memiliki ketergantungan pada JAR mandiri pengujian Greengrass.

Langkah 3: Bangun kasus uji khusus

Menulis kasus uji khusus secara luas terdiri dari dua langkah: membuat file fitur dengan skenario pengujian dan menerapkan definisi langkah. Untuk contoh pembuatan kasus uji kustom, lihatContoh: Membangun kasus uji khusus. Gunakan langkah-langkah berikut untuk membuat kasus uji kustom Anda:

  1. Buat file fitur dengan skenario pengujian

    Sebuah fitur biasanya menggambarkan fungsionalitas spesifik dari perangkat lunak yang sedang diuji. Di Cucumber, setiap fitur ditentukan sebagai file fitur individual dengan judul, deskripsi rinci, dan satu atau lebih contoh kasus tertentu yang disebut skenario. Setiap skenario terdiri dari judul, deskripsi rinci, dan serangkaian langkah yang menentukan interaksi dan hasil yang diharapkan. Skenario ditulis dalam format terstruktur menggunakan kata kunci “diberikan,” “kapan,” dan “lalu”.

  2. Menerapkan definisi langkah

    Definisi langkah menghubungkan langkah Gherkin dalam bahasa sederhana ke kode program. Ketika Mentimun mengidentifikasi langkah Gherkin dalam skenario, itu akan mencari definisi langkah yang cocok untuk dijalankan.

Langkah 4: Tambahkan tag ke kasus uji baru

  • Anda dapat menetapkan tag ke fitur dan skenario untuk mengatur proses pengujian. Anda dapat menggunakan tag untuk mengkategorikan subset skenario dan juga memilih kait secara kondisional untuk dijalankan. Fitur dan skenario dapat memiliki beberapa tag yang dipisahkan oleh spasi.

    Dalam contoh ini, kita menggunakan HelloWorld komponen.

    Dalam file fitur, tambahkan tag baru bernama @HelloWorld di samping @Sample tag.

    @Sample @HelloWorld
Scenario: As a developer, I can create a component and deploy it on my device
....

Langkah 5: Bangun JAR tes

  1. Membangun komponen. Anda harus membangun komponen sebelum membangun modul pengujian.

    gdk component build

  2. Bangun modul pengujian menggunakan perintah berikut. Perintah ini akan membangun JAR pengujian di greengrass-build folder.

    gdk test-e2e build

Langkah 6: Jalankan tes

Saat Anda menjalankan kasus uji khusus, GTF mengotomatiskan siklus hidup pengujian bersama dengan mengelola sumber daya yang dibuat selama pengujian. Ini pertama-tama menyediakan perangkat yang sedang diuji (DUT) sebagai AWS IoT sesuatu dan menginstal perangkat lunak inti Greengrass di atasnya. Kemudian akan membuat komponen baru bernama HelloWorld menggunakan resep yang ditentukan di jalur itu. HelloWorldKomponen tersebut kemudian dikerahkan ke perangkat inti melalui penerapan hal Greengrass. Ini kemudian akan diverifikasi jika penerapan berhasil. Status penerapan akan berubah menjadi COMPLETED dalam waktu 3 menit jika penerapan berhasil.

  1. Buka gdk-config.json file di direktori proyek untuk menargetkan tes dengan HelloWorld tag. Perbarui test-e2e kunci menggunakan perintah berikut.

      "test-e2e":{
    "gtf_options" : { 
         "tags":"HelloWorld"
     }
  }

  2. Sebelum menjalankan pengujian, Anda harus memberikan AWS kredensi ke perangkat host. GTF menggunakan kredensi ini untuk mengelola AWS sumber daya selama proses pengujian. Pastikan peran yang Anda berikan memiliki izin untuk mengotomatiskan operasi yang diperlukan yang disertakan dalam pengujian.

    Jalankan perintah berikut untuk memberikan AWS kredensialnya.

    1. Linux or Unix
      export AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE
export AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
      Windows Command Prompt (CMD)
      set AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE
set AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
      PowerShell
      $env:AWS_ACCESS_KEY_ID="AKIAIOSFODNN7EXAMPLE"
$env:AWS_SECRET_ACCESS_KEY="wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY"

  3. Jalankan tes menggunakan perintah berikut.

    gdk test-e2e run

    Perintah ini mengunduh versi terbaru dari inti Greengrass di folder dan menjalankan pengujian greengrass-build menggunakannya. Perintah ini juga hanya menargetkan skenario dengan HelloWorld tag dan menghasilkan laporan untuk skenario tersebut. Anda akan melihat AWS sumber daya yang dibuat selama tes ini dibuang di akhir tes.

Contoh: Membangun kasus uji khusus

Modul pengujian yang diunduh dalam proyek GDK terdiri dari fitur sampel dan file implementasi langkah.

Dalam contoh berikut, kami membuat file fitur untuk menguji fitur penyebaran hal dari perangkat lunak Greengrass. Kami menguji sebagian fungsionalitas fitur ini dengan skenario yang melakukan penerapan komponen melalui AWS Cloud Greengrass. Ini adalah serangkaian langkah yang membantu kita memahami interaksi dan hasil yang diharapkan dari kasus penggunaan ini.

  1. Buat file fitur

    Arahkan ke gg-e2e-tests/src/main/resources/greengrass/features folder di direktori saat ini. Anda dapat menemukan sampel component.feature yang terlihat seperti contoh berikut.

    Dalam file fitur ini, Anda dapat menguji fitur penyebaran benda dari perangkat lunak Greengrass. Anda dapat menguji sebagian fungsionalitas fitur ini dengan skenario yang melakukan penerapan komponen melalui cloud Greengrass. Skenario ini adalah serangkaian langkah yang membantu memahami interaksi dan hasil yang diharapkan dari kasus penggunaan ini.

    Feature: Testing features of Greengrassv2 component

Background:
    Given my device is registered as a Thing
    And my device is running Greengrass

@Sample
Scenario: As a developer, I can create a component and deploy it on my device
    When I create a Greengrass deployment with components
        HelloWorld | /path/to/recipe/file
    And I deploy the Greengrass deployment configuration
    Then the Greengrass deployment is COMPLETED on the device after 180 seconds
    And I call my custom step

    GTF berisi definisi langkah dari semua langkah berikut, kecuali untuk langkah bernama:And I call my custom step.

  2. Menerapkan definisi langkah

    JAR mandiri GTF berisi definisi langkah dari semua langkah kecuali satu langkah:. And I call my custom step Anda dapat menerapkan langkah ini dalam modul pengujian.

    Arahkan ke kode sumber file pengujian. Anda dapat menautkan langkah kustom Anda menggunakan definisi langkah dengan menggunakan perintah berikut.

    
@And("I call my custom step")
public void customStep() {
    System.out.println("My custom step was called ");
}