Sampel skrip Azure CLI - membuat aplikasi logika

Artikel
01/04/2024

Berlaku pada: Azure Logic Apps (Konsumsi)

Skrip ini membuat contoh aplikasi logika melalui ekstensi Azure CLI Logic Apps , (az logic). Untuk panduan terperinci untuk membuat dan mengelola aplikasi logika melalui Azure CLI, lihat mulai cepat Logic Apps untuk Azure CLI.

Peringatan

Ekstensi Azure Logic Apps CLI saat ini bersifat eksperimental dan tidak tercakup oleh dukungan pelanggan. Gunakan ekstensi CLI ini dengan hati-hati, terutama jika Anda memilih untuk menggunakan ekstensi di lingkungan produksi.

Prasyarat

Akun Azure dengan langganan aktif. Jika Anda tidak memiliki langganan Azure, buatlah akun gratis.
Azure CLI dipasang di komputer lokal Anda.
Ekstensi Azure Logic Apps CLI terpasang di komputer Anda. Untuk memasang ekstensi ini, gunakan perintah ini: az extension add --name logic
Definisi alur kerja untuk aplikasi logika Anda. File JSON ini harus mengikuti skema bahasa Definisi Alur Kerja.
Koneksi API ke akun email melalui konektor Azure Logic Apps yang didukung di grup sumber daya yang sama dengan aplikasi logika Anda. Contoh ini menggunakan konektor Outlook Office 365, tapi Anda juga bisa menggunakan konektor lain seperti Outlook.com.

Pemeriksaan prasyarat

Validasi lingkungan Anda sebelum memulai:

Masuk ke portal Microsoft Azure dan pastikan langganan Anda aktif dengan menjalankan az login.
Periksa versi Azure CLI Anda di terminal atau jendela perintah dengan menjalankan az --version. Untuk versi terbaru, lihat catatan rilis terbaru.
- Jika Anda tidak memiliki versi terbaru, perbarui penginstalan Anda dengan mengikuti panduan penginstalan sistem operasi atau platform Anda.

Contoh penjelasan alur kerja

Contoh file definisi alur kerja ini membuat contoh dasar alur kerja aplikasi logika Konsumsi yang sama seperti dalam mulai cepat untuk portal Azure.

Contoh alur kerja ini:

Menentukan skema, $schema, untuk aplikasi logika.
Mendefinisikan pemicu untuk aplikasi logika dalam daftar pemicu, triggers. Pemicunya berulang (recurrence) setiap 3 jam. Tindakan dipicu ketika item umpan baru diterbitkan (When_a_feed_item_is_published) untuk umpan RSS yang ditentukan (feedUrl).
Mendefinisikan tindakan untuk aplikasi logika dalam daftar tindakan, actions. Tindakan mengirim email (Send_an_email_(V2)) melalui Microsoft 365 dengan detail dari item umpan RSS seperti yang ditentukan di bagian isi (body) input tindakan (inputs).

Contoh definisi alur kerja

Sebelum Anda menjalankan contoh skrip, Anda harus terlebih dahulu membuat contoh definisi alur kerja.

Buat file JSON, testDefinition.json di komputer Anda.

Salin konten berikut ke dalam file JSON:


{
    "definition": {
        "$schema": "https://schema.management.azure.com/providers/Microsoft.Logic/schemas/2016-06-01/workflowdefinition.json#",
        "actions": {
            "Send_an_email_(V2)": {
                "inputs": {
                    "body": {
                        "Body": "<p>@{triggerBody()?['publishDate']}<br>\n@{triggerBody()?['title']}<br>\n@{triggerBody()?['primaryLink']}</p>",
                        "Subject": "@triggerBody()?['title']",
                        "To": "test@example.com"
                    },
                    "host": {
                        "connection": {
                            "name": "@parameters('$connections')['office365']['connectionId']"
                        }
                    },
                    "method": "post",
                    "path": "/v2/Mail"
                },
                "runAfter": {},
                "type": "ApiConnection"
            }
        },
        "contentVersion": "1.0.0.0",
        "outputs": {},
        "parameters": {
            "$connections": {
                "defaultValue": {},
                "type": "Object"
            }
        },
        "triggers": {
            "When_a_feed_item_is_published": {
                "inputs": {
                    "host": {
                        "connection": {
                            "name": "@parameters('$connections')['rss']['connectionId']"
                        }
                    },
                    "method": "get",
                    "path": "/OnNewFeed",
                    "queries": {
                        "feedUrl": "https://www.pbs.org/now/rss.xml"
                    }
                },
                "recurrence": {
                    "frequency": "Hour",
                    "interval": 3
                },
                "splitOn": "@triggerBody()?['value']",
                "type": "ApiConnection"
            }
        }
    },
    "parameters": {
        "$connections": {
            "value": {
                "office365": {
                    "connectionId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testResourceGroup/providers/Microsoft.Web/connections/office365",
                    "connectionName": "office365",
                    "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Web/locations/westus/managedApis/office365"
                },
                "rss": {
                    "connectionId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testResourceGroup/providers/Microsoft.Web/connections/rss",
                    "connectionName": "rss",
                    "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Web/locations/westus/managedApis/rss"
                }
            }
        }
    }
}

Perbarui nilai tempat penampung dengan informasi Anda sendiri:
1. Mengganti alamat email tempat penampung ("To": "test@example.com"). Anda perlu menggunakan alamat email yang kompatibel dengan konektor Logic Apps. Untuk informasi selengkapnya, lihat prasyarat.
2. Ganti detail konektor tambahan jika Anda menggunakan konektor email lain selain konektor Office 365 Outlook.
3. Ganti nilai langganan tempat penampung (00000000-0000-0000-0000-000000000000) untuk pengidentifikasi koneksi Anda (connectionId dan id) di bawah parameter koneksi ( $connections) dengan nilai langganan Anda sendiri.
Simpan perubahan Anda.

Skrip sampel

Catatan

Sampel ini ditulis untuk shellbash. Jika Anda ingin menjalankan sampel ini di shell lain, seperti Windows PowerShell atau Command Prompt, Anda mungkin perlu melakukan modifikasi pada skrip Anda.

Sebelum Anda menjalankan contoh skrip ini, jalankan perintah ini untuk menyambungkan ke Azure:


az login

Selanjutnya, navigasikan ke direktori tempat Anda membuat definisi alur kerja. Misalnya, jika Anda membuat file JSON definisi alur kerja di desktop Anda:


cd ~/Desktop

Kemudian, jalankan skrip ini untuk membuat aplikasi logika.


#!/bin/bash

# Create a resource group

az group create --name testResourceGroup --location westus

# Create your logic app

az logic workflow create --resource-group "testResourceGroup" --location "westus" --name "testLogicApp" --definition "testDefinition.json"

Menghapus penyebaran

Setelah selesai menggunakan contoh skrip, jalankan perintah berikut untuk menghapus grup sumber daya dan semua sumber daya yang bersarang, termasuk aplikasi logika.


az group delete --name testResourceGroup --yes

Penjelasan skrip

Contoh skrip ini menggunakan perintah berikut untuk membuat grup sumber daya dan aplikasi logika baru.

Perintah	Catatan
`az group create`	Membuat grup sumber daya yang mana aplikasi logika Anda akan disimpan.
`az logic workflow create`	Membuat aplikasi logika berdasarkan alur kerja yang ditentukan dalam parameter `--definition`.
`az group delete`	Menghapus grup sumber daya dan semua sumber daya yang bersarang.

Langkah berikutnya

Untuk informasi lebih tentang Azure CLI, lihat dokumentasi Azure CLI.

Anda dapat menemukan sampel skrip Azure Logic Apps CLI tambahan di browser sampel kode Microsoft.

Bagikan melalui