Bagikan melalui


Tutorial: Menambahkan lingkungan dan penyebaran untuk API

Tutorial ini menjelaskan cara menambah inventori di pusat API Anda dengan menambahkan informasi tentang lingkungan dan penyebaran API.

  • Lingkungan mewakili lokasi tempat runtime API dapat disebarkan, misalnya, platform manajemen API.
  • Penyebaran adalah lokasi, atau alamat, tempat pengguna dapat mengakses API.

Untuk informasi selengkapnya tentang API, penyebaran, dan entitas lain yang dapat Anda inventarisasi di Azure API Center, lihat Konsep utama.

Dalam tutorial ini, Anda mempelajari cara menggunakan portal untuk:

  • Menambahkan informasi tentang lingkungan API
  • Menambahkan informasi tentang penyebaran API

Prasyarat

Tambahkan lingkungan

Gunakan pusat API Anda untuk melacak lingkungan API dunia nyata Anda. Misalnya, Anda dapat menggunakan Azure API Management atau solusi lain untuk mendistribusikan, mengamankan, dan memantau beberapa API Anda. Atau Anda mungkin langsung melayani beberapa API menggunakan layanan komputasi atau kluster Kubernetes.

Di sini Anda menambahkan informasi tentang lingkungan Azure API Management fiktif ke pusat API Anda. Jika mau, tambahkan informasi tentang salah satu lingkungan Anda yang sudah ada. Konfigurasikan metadata bawaan dan metadata kustom apa pun yang Anda tentukan dalam tutorial sebelumnya.

  1. Masuk ke portal Microsoft Azure, lalu navigasikan ke pusat API Anda.

  2. Di menu bar samping, di bawah Aset, pilih Lingkungan>+ Lingkungan baru.

  3. Pada halaman Lingkungan baru, tambahkan informasi berikut. Jika sebelumnya Anda menentukan metadata Lini bisnis kustom atau metadata lain yang ditetapkan ke lingkungan, Anda melihatnya di bagian bawah halaman.

    Setting Nilai Description
    Judul lingkungan Masukkan Pengujian Saya. Nama yang Anda pilih untuk lingkungan
    Identifikasi Setelah Anda memasukkan judul sebelumnya, Azure API Center menghasilkan pengidentifikasi ini, yang dapat Anda ambil alih. Nama sumber daya Azure untuk lingkungan
    jenis lingkungan Pilih Pengujian dari menu dropdown. Jenis lingkungan untuk API
    Deskripsi Secara opsional, masukkan deskripsi. Deskripsi lingkungan
    Server
    Type Secara opsional, pilih Azure API Management dari menu dropdown. Jenis solusi manajemen API yang digunakan
    URL portal manajemen Secara opsional, masukkan URL untuk antarmuka manajemen, seperti https://admin.contoso.com URL antarmuka manajemen untuk lingkungan
    Onboarding
    URL portal pengembangan Secara opsional, masukkan URL untuk portal pengembang, seperti https://developer.contoso.com URL antarmuka untuk pengenalan pengembang di lingkungan pengembangan
    Petunjuk Secara opsional, pilih Edit dan masukkan instruksi onboarding di Markdown standar. Petunjuk untuk memulai API dari lingkungan perangkat lunak
    Lini bisnis Jika Anda menambahkan metadata kustom ini, secara opsional buat pilihan dari menu dropdown, seperti IT. Metadata kustom yang mengidentifikasi unit bisnis yang mengelola lingkungan

    Cuplikan layar menambahkan lingkungan API di portal.

  4. Pilih Buat. Lingkungan muncul di daftar lingkungan.

Menambahkan penyebaran

Pusat API juga dapat membantu Anda membuat katalog penyebaran API dan lingkungan waktu proses tempat API yang Anda lacak disebarkan.

Di sini Anda menambahkan penyebaran dengan mengaitkan salah satu API Anda dengan lingkungan yang Anda buat di bagian sebelumnya. Anda mengonfigurasi metadata bawaan dan metadata kustom apa pun yang Anda tentukan.

  1. Di portal Microsoft Azure, navigasikan ke pusat API Anda.

  2. Di menu bar samping, di bawah Aset, pilih API.

  3. Pilih API, misalnya, API Konferensi.

  4. Pada halaman API Konferensi, di bawah Detail, pilih

  5. Di halaman Tambahkan penyebaran , tambahkan informasi berikut. Jika sebelumnya Anda telah menentukan metadata kustom Lini bisnis atau metadata lain yang ditetapkan ke lingkungan, Anda dapat melihatnya di bagian bawah halaman.

    Setting Nilai Description
    Title Masukkan Penyebaran V1. Nama yang Anda pilih untuk penyebaran
    Identifikasi Setelah Anda memasukkan judul sebelumnya, Azure API Center menghasilkan pengidentifikasi ini, yang dapat Anda ambil alih. Nama sumber daya Azure untuk penyebaran
    Deskripsi Secara opsional, masukkan deskripsi. Deskripsi penyebaran
    Lingkungan Buat pilihan dari menu dropdown, seperti Pengujian Saya, atau secara opsional pilih Buat baru. Lingkungan baru atau yang sudah ada tempat versi API disebarkan
    Definisi Pilih atau tambahkan file definisi untuk versi API Konferensi. File definisi API
    Runtime URL Masukkan URL dasar, misalnya, https://api.contoso.com. URL runtime dasar untuk API di lingkungan
    Lini bisnis Jika Anda menambahkan metadata kustom ini, secara opsional buat pilihan dari menu dropdown, seperti IT. Metadata kustom yang mengidentifikasi unit bisnis yang mengelola API di lingkungan

    Cuplikan layar menambahkan penyebaran API di portal.

  6. Pilih Buat. Penyebaran muncul pada daftar penyebaran.

Dalam tutorial ini, Anda mempelajari cara menggunakan portal untuk:

  • Menambahkan informasi tentang lingkungan API
  • Menambahkan informasi tentang penyebaran API