Anda sedang melihat dokumentasi Apigee Edge.
Buka
dokumentasi Apigee X. info
Apigee menggunakan Pantheon, layanan pengelolaan situs, untuk menghosting versi portal Layanan Developer berbasis cloud. Pantheon dirancang agar dapat digunakan dengan Drupal untuk memungkinkan Anda mengembangkan, menguji, dan memublikasikan portal di lingkungan yang aman. Layanan pengelolaan situs Pantheon tersedia bagi pelanggan yang memiliki kebutuhan operasi hosting dan pengembangan di seluruh dunia.
Bagian berikut menjelaskan cara menggunakan Pantheon untuk mengembangkan dan mengelola portal Anda.
Mengakses dasbor Pantheon
Saat Apigee mengirimkan URL portal, Anda juga akan menerima URL Dasbor Pantheon: https://dashboard.getpantheon.com/.
Saat pertama kali login ke dasbor Pantheon, Anda akan diarahkan ke halaman Situs, yang ditampilkan di bawah ini:
Dari dasbor, Anda dapat mengakses situs, mengonfigurasi akun, dan melakukan operasi lainnya.
Pilih gambar situs Anda (misalnya apigeedocs) untuk membuka dasbor situs tersebut:
Mengelola lingkungan Anda
Di dasbor Pantheon, ada tiga lingkungan yang tercantum di bagian atas halaman: Dev, Test, dan Live. Masing-masing kebijakan dijelaskan dalam tabel berikut.
|
Lingkungan |
Deskripsi |
|---|---|
|
Pengembangan |
Lingkungan Dev terhubung ke repo Git Anda. Setiap perubahan yang Anda kirim ke Git akan segera muncul di lingkungan Dev. URL ke situs ini menggunakan format di bawah, dengan org_name adalah nama organisasi Anda: http://dev-{org_name}.devportal.apigee.io/ |
|
Pengujian |
Lingkungan Test digunakan untuk menguji kode terbaru dengan salinan data dari lingkungan Live. Lingkungan ini adalah tempat Anda menguji perubahan kode sebelum mengirimkannya ke lingkungan Live. URL ke situs ini menggunakan format di bawah, dengan org_name adalah nama organisasi Anda: http://test-{org_name}.devportal.apigee.io/ |
|
Live |
Lingkungan Live adalah lingkungan produksi yang Anda buat agar dapat diakses oleh pelanggan. URL ke situs ini menggunakan format di bawah, dengan org_name adalah nama organisasi Anda: http://live-{org_name}.devportal.apigee.io/ |
Mengembangkan konten portal Anda
Bagian berikut menjelaskan cara mengembangkan konten portal Anda.
- Ringkasan repositori Git
- Mengakses kode Anda
- Men-deploy kode ke lingkungan portal Anda
- Menambahkan modul dan tema kustom
- Mengganti modul profil dan tema Drupal
Selain itu, lihat bagian berikut untuk mengetahui detail lebih lanjut tentang cara menyesuaikan portal.
|
Jika Anda ingin... |
Anda dapat |
Informasi Selengkapnya |
|---|---|---|
|
Mengubah tampilan dan nuansa situs |
Dasar - Gunakan entri menu Appearance pada situs portal untuk membuat perubahan, seperti memodifikasi warna situs dan logo. |
Lihat Menyesuaikan tampilan: |
|
Lanjutan - Untuk memodifikasi tampilan dan nuansa lengkap situs, perluas tema Responsif Apigee. |
Lihat Menyesuaikan tema |
|
|
Mengubah perilaku fungsi situs |
Dasar - Gunakan setelan admin di portal untuk mengubah/mengonfigurasi perilaku situs. |
Lihat dokumentasi Apigee mulai di sini |
|
Lanjutan - Buat modul kustom untuk mengubah perilaku situs. |
Lihat Membuat modul kustom di dokumentasi Drupal |
Ringkasan repositori Git
Repositori Git untuk kode Drupal Anda berisi semua kode portal dan diatur menggunakan struktur berikut.
Catatan: Hanya ubah konten dalam direktori /sites/all. Jika
Anda mengubah konten yang berada di luar direktori /sites/all, Anda akan mengalami masalah
saat mengupgrade ke versi baru dan mungkin mengalami konflik penggabungan saat memeriksa perubahan pada
Git.
|
Folder di repositori Git |
Deskripsi |
|---|---|
/profiles/apigee |
Apigee mengelola modul dan tema, termasuk:
Catatan: Jangan ubah konten di direktori /profiles/apigee atau Anda akan mengalami masalah saat mengupgrade ke versi baru dan mungkin mengalami konflik penggabungan saat memeriksa perubahan pada Git. Untuk mengetahui praktik terbaik Drupal, lihat Jangan pernah meretas core. |
/sites/all |
Modul dan tema Drupal kustom Anda. Untuk informasi tentang cara mengelola konten dalam folder ini, lihat Menambahkan modul dan tema kustom serta Mengganti modul dan tema profil Drupal. Catatan: Hanya ubah konten dalam direktori /sites/all. |
Mengakses kode Anda
Untuk mengakses repositori kode di Git, Anda perlu melakukan tugas yang dijelaskan di bagian berikut:
Lihat juga Bagaimana cara mengakses kode sumber portal developer Drupal 7?
Mengaktifkan akses SSH ke server Anda
Agar dapat menggunakan Git untuk mengelola kode Drupal, Anda harus mengaktifkan SSH untuk mengakses server dengan mengupload kunci SSH ke Pantheon.
Untuk mengaktifkan akses SSH ke server Anda:
- Login ke Pantheon di https://dashboard.getpantheon.com/.
- Di dasbor, pilih Akun.
- Pilih SSH Keys di menu sebelah kiri.
- Tambahkan kunci Anda, lalu pilih Tambahkan kunci.
Jika Anda memerlukan bantuan, pilih link Learn how to generate an SSH Key.
Mengakses repositori kode Anda di Git
Catatan: Lihat Ringkasan repositori Git untuk mengetahui ringkasan struktur repositori Git.
Untuk mengakses repositori kode Anda di Git:
- Masuk ke dasbor Pantheon.
- Dari halaman utama Sites, pilih ikon portal Anda.
- URL repo Git muncul di halaman sebelah kanan Connection Mode, seperti yang ditunjukkan pada gambar sebelumnya.
- Salin URL repo Git Anda dan clone ke lingkungan pengembangan lokal Anda menggunakan
perintah:
> git clone gitURL sitename
Misalnya:
> git clone ssh://codeserver.dev.12@codeserver.dev.12.drush.in:2222/~/repository.git devportal
Setiap perubahan kode yang Anda kirim ke repo Git akan langsung muncul di lingkungan Dev portal Anda.
Men-deploy kode ke lingkungan portal Anda
Untuk membuat kode ke lingkungan portal Anda:
- Kirim update kode Anda ke Git, yang akan langsung mengupdate lingkungan Dev.
- Login ke Pantheon, lalu pilih situs Anda.
- Pilih lingkungan Dev.
- Pilih </>Code di menu sebelah kiri untuk melihat pesan tentang perubahan
kode Anda di Commit Log:
- Pilih lingkungan Pengujian di bagian atas halaman.
- Jika belum mengupload Dev ke Test, Anda akan diminta untuk melakukannya sekarang.
- Jika Anda sudah memiliki lingkungan Test, pesan yang menunjukkan bahwa ada commit dari Dev siap untuk di-deploy:
- Jika sudah mengirim situs ke lingkungan Live, Anda dapat memilih kotak centang ketiga untuk menyalin database langsung dan file apa pun yang diupload oleh developer ke Test dari Live. Cara ini berguna jika Anda ingin menguji perubahan kode terhadap data terbaru yang tersedia di Live.
- Pilih tombol Deploy Code from Development.
- Uji portal di lingkungan Test.
- Lakukan perbaikan kode apa pun ke lingkungan Dev dan kirim file lagi ke Test untuk pengujian.
- Setelah pengujian selesai, pilih lingkungan Live di bagian atas halaman.
- Jika belum mengupload Test ke Live, Anda akan diminta untuk melakukannya sekarang.
- Jika Anda sudah memiliki lingkungan Live, akan muncul pesan yang menunjukkan bahwa ada commit dari Test yang siap untuk di-deploy. Deploy perubahan tersebut dengan cara yang sama seperti saat Anda men-deploy-nya ke Test dari Dev. Setelah selesai melakukan pengujian, kirim kode ke lingkungan Live.
Pelajari lebih lanjut:
- Pantheon menyediakan sekumpulan Live Articles tentang proses ini yang dapat Anda lihat. Salah satu yang paling penting adalah artikel Menggunakan Alur Kerja Pantheon yang memberikan ringkasan tentang cara mengembangkan, menguji, dan mendorong situs Anda.
Menambahkan modul dan tema kustom
Anda dapat memperluas fungsionalitas portal dengan menambahkan modul dan tema kustom Anda sendiri ke folder yang tercantum dalam tabel berikut.
Catatan: Hanya ubah konten dalam direktori /sites/all. Jika Anda mengubah konten yang berada di luar direktori /sites/all, Anda mungkin akan mengalami konflik penggabungan saat memeriksa perubahan pada Git.
| Modul/Tema | Folder di repositori Git | Informasi selengkapnya (dokumentasi Drupal) |
| Modul kustom | sites/all/modules/custom |
Membuat modul kustom |
| Tema khusus | sites/all/themes |
Menyesuaikan
tema Tema Drupal 7 |
Setelah menambahkan modul atau tema kustom di lingkungan Dev, Anda dapat men-deploy-nya ke Test untuk pengujian, lalu ke lingkungan Live untuk produksi, seperti yang dijelaskan dalam Men-deploy kode ke lingkungan portal Anda.
Mengganti modul dan tema profil Drupal
Modul dan tema dalam direktori berikut menggantikan modul dan tema profil Drupal
yang dikelola dan didistribusikan oleh Apigee di /profiles/apigee.
Lihat Ringkasan repositori Git Anda.
Misalnya, Anda mungkin ingin mengganti modul dalam distribusi Drupal Apigee dalam skenario berikut:
- Anda ingin menggunakan versi lain dari modul tertentu.
- Anda ingin mengimplementasikan update keamanan sebelum rilis Apigee terjadwal berikutnya.
| Modul/Tema | Folder di repositori Git | Informasi selengkapnya (dokumentasi Drupal) |
| Modul Kontribusi Drupal |
Catatan: Modul yang disimpan di mana saja dalam |
Modul kontribusi
Catatan: Modul kontribusi Drupal dalam direktori ini menggantikan modul setara yang dikelola dan didistribusikan oleh Apigee di |
| Tema Kontribusi Drupal | sites/all/themes |
Tema yang dikontribusikan
Catatan: Tema yang dikontribusikan Drupal dalam direktori ini menggantikan modul setara yang dikelola dan didistribusikan oleh Apigee di |
Tentang file settings.php
Drupal settings.php di-commit ke repo Git upstream Portal Developer Apigee Drupal. Jika Anda ingin melakukan perubahan pada file sites/default/settings.php, jangan edit file tersebut secara langsung.
Sebagai gantinya, buat file bernama sites/default/settings.local.php dan tempatkan kode kustom Anda di sana. sites/default/settings.local.php disertakan oleh file settings.php.
Misalnya, saat menyiapkan domain kustom untuk situs live dengan mengikuti petunjuk yang diberikan oleh Pantheon, alih-alih mengubah file settings.php secara langsung, tambahkan pembaruan yang diperlukan di sites/default/settings.local.php.
Mengamankan portal Anda
Situs portal yang terkait dengan lingkungan Dev, Test, dan Live dapat diakses secara publik secara default. Artinya, siapa pun yang memiliki URL situs dapat mengaksesnya, meskipun mereka mungkin tidak dapat mendaftarkan akun atau login ke situs. Untuk informasi selengkapnya tentang mengontrol pendaftaran pengguna, lihat Menambahkan dan mengelola akun pengguna.
Anda mungkin ingin menyembunyikan situs Dev dan Test dari publik, dan ingin menyembunyikan situs Live sampai Anda menyelesaikan pengembangan. Pantheon memungkinkan Anda menambahkan kontrol nama pengguna/sandi untuk mengunci situs sehingga hanya orang dengan kredensial yang tepat yang dapat mengaksesnya.
Tambahkan penguncian ke salah satu dari tiga lingkungan dengan memilih Security di menu sebelah kiri untuk lingkungan tersebut. Untuk informasi selengkapnya, lihat Mengunci Situs.
Jika ingin mengaktifkan TLS/SSL untuk situs Anda, lihat Menggunakan TLS di portal.
Menerapkan update Apigee ke portal Anda
Saat Apigee memublikasikan rilis baru portal, pesan akan muncul di Dasbor Pantheon.
Anda biasanya menerapkan update pada lingkungan Dev, lalu menguji perubahan tersebut dengan cara yang sama seperti saat Anda menguji perubahan kode Anda sendiri. Misalnya, kirim lingkungan Dev ke Test, kirim data langsung dari Live ke Test, lalu uji update.
Untuk menerapkan update:
- Login ke Pantheon di https://dashboard.getpantheon.com/ dan pilih situs Anda.
- Pilih lingkungan Dev.
- Pilih entri menu </>Code di sebelah kiri. Jika tersedia, update Apigee akan dicantumkan.
- Terapkan update:
-
Pilih kotak centang Run update.php setelah menarik kode.
-
Jika tersedia, centang kotak Clear caches after pulling.
-
Pilih tombol Deploy Code.
-
- Setelah update selesai, pilih item menu Status di sebelah kiri dasbor.
- Di area Status lingkungan, Anda mungkin melihat error untuk update database, seperti ditunjukkan di bawah ini:
Jika Anda melihat error ini di lingkungan mana pun, perbarui database secara manual:
- Login ke portal Anda sebagai pengguna yang memiliki hak istimewa pembuatan konten atau admin.
- Pilih ikon Home > Run updates di sudut kiri atas portal.
- Ikuti petunjuk untuk memperbarui database.
- Kirim perubahan kode ke lingkungan Test, lalu kirim ke Live, seperti dijelaskan di atas.
Memigrasikan fitur kustom
Jika menambahkan kode atau fitur kustom ke portal, Anda harus memutuskan cara memeliharanya dan cara memindahkannya dari lingkungan Dev ke Test ke Live.
Untuk kode dalam repo Git, Anda dapat menggunakan proses yang dijelaskan dalam Men-deploy kode ke lingkungan portal untuk memigrasikan kode dari Dev ke Test ke Live.
Jika Anda telah membuat konfigurasi kustom, gunakan salah satu metode berikut untuk memigrasikannya:
| Metode | Deskripsi |
| Mengekspor konfigurasi ke kode | Banyak konfigurasi umum yang "dapat diekspor" ke kode menggunakan modul Fitur. Misalnya, tampilan, panel, cache gambar, dan sebagainya. |
Mengimplementasikan fungsi hook_update_N() |
Drupal mengelola perubahan database dan konfigurasi menggunakan fungsi hook_update_N().
Jika memiliki modul kustom, Anda dapat:
|
Lihat juga Menggunakan Alur Kerja Pantheon yang memberikan ringkasan tentang cara mengembangkan, menguji, dan mendorong situs Anda. Bagian tentang Configuration Management turut disertakan dalam artikel tersebut.
Mengonfigurasi domain kustom
Nama domain yang disediakan Apigee untuk portal secara default adalah apigee.io, seperti yang dijelaskan dalam Mengelola lingkungan Anda, yang mungkin bukan yang ingin Anda ekspos kepada pelanggan.
Paket portal berbayar dapat mengonfigurasi nama domain kustom untuk portal tersebut (Akun developer, atau akun gratis, tidak dapat membuat domain kustom). Untuk menggunakan domain kustom, buat CNAME di DNS Anda dan arahkan domain Anda ke edge.apigee.getpantheon.com.
Misalnya, untuk mengonfigurasi domain kustom untuk perusahaan bernama Mytech:
- Konfigurasikan setelan DNS berikut:
developer.mytech.com. 3600 IN CNAME edge.apigee.getpantheon.com
Diperlukan waktu hingga 48 jam agar perubahan DNS ini diterapkan untuk semua perangkat klien. - Gunakan entri menu Domains / SSL di sebelah kiri dasbor untuk menambahkan domain ini ke dasbor Pantheon hanya untuk lingkungan Live.
Pada umumnya, Anda hanya mengonfigurasi DNS untuk lingkungan Live, bukan untuk Dev dan Test. Anda tidak boleh menggunakan lingkungan Dev atau Test untuk produksi.
Untuk informasi selengkapnya, lihat dokumentasi Pantheon di sini.
Menambahkan administrator portal
Saat Anda menerima email dari Apigee yang menyatakan bahwa portal Anda sudah siap, Apigee telah mengonfigurasi daftar administrator portal. Anda dapat melihat daftar tersebut dengan memilih link Tim di sisi kanan atas dasbor situs.
Untuk menambahkan administrator tambahan, lihat Membuat pengguna admin.
Mencadangkan portal
Untuk mencadangkan portal, gunakan tab Cadangan di dasbor Pantheon. Anda dapat membuat pencadangan sesuai permintaan atau otomatis. Di Pantheon, cadangan terdiri dari tiga arsip terpisah: database, file, dan kode.
Untuk informasi selengkapnya, lihat Alat Cadangan di dokumentasi Pantheon.
Berlangganan pembaruan status
Anda dapat berlangganan rilis Apigee dan update status di status.apigee.com. Klik Subscribe to Updates, masukkan informasi kontak Anda, seperti alamat email, saat diminta, lalu klik Subscribe. Di halaman pengelolaan notifikasi email, pastikan Portal Developer sudah dipilih, aktifkan setelan notifikasi lain sesuai kebutuhan, lalu klik Perbarui Preferensi.
Anda dapat berlangganan ke pembaruan status Pantheon dan laporan insiden, seperti saat pemadaman terjadi, di http://status.getpantheon.com. Klik Berlangganan ke Pembaruan untuk mendaftar.