Bagikan melalui

Tutorial: Menambahkan lingkungan dan penyebaran untuk API

  • Artikel

Pertambahkan 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 (alamat) tempat pengguna dapat mengakses API.

Untuk informasi latar belakang 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

  • Pusat API di langganan Azure Anda. Jika Anda belum membuatnya, lihat Mulai Cepat: Membuat pusat API Anda.

  • Satu atau beberapa API yang terdaftar di pusat API Anda. Jika Anda belum mendaftarkan API apa pun, lihat Tutorial: Mendaftarkan API di inventarisasi API Anda. Tutorial ini menggunakan sampel API yang Anda tambahkan dari tutorial sebelumnya.

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. Anda akan mengonfigurasi metadata bawaan dan metadata kustom apa pun yang Anda tentukan dalam tutorial sebelumnya.

  1. Di portal, navigasikan ke pusat API Anda.

  2. Di menu sebelah kiri, 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 akan melihatnya di bagian bawah halaman.

    Pengaturan Nilai Deskripsi
    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.
    Keterangan Secara opsional masukkan deskripsi. Deskripsi lingkungan.
    Server
    Jenis 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 orientasi pengembang di lingkungan.
    Petunjuk Secara opsional pilih Edit dan masukkan instruksi onboarding di Markdown standar. Instruksi untuk onboarding ke API dari 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 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 - lingkungan runtime 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 akan mengonfigurasi metadata bawaan dan metadata kustom apa pun yang Anda tentukan.

  1. Di portal, navigasikan ke pusat API Anda.

  2. Di menu sebelah kiri, di bawah Aset, pilih API.

  3. Pilih API, misalnya, API Konferensi Demo.

  4. Pada halaman DEMO Conference API, di bawah Detail, pilih Penyebaran>+ Tambahkan penyebaran.

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

    Pengaturan Nilai Deskripsi
    Judul 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.
    Keterangan 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 Demo. 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

Konten terkait