Anda sedang melihat dokumentasi Apigee Edge.
Buka
dokumentasi Apigee X. info
Apigee menggunakan Acquia, sebuah layanan pengelolaan situs, untuk menghosting versi portal Layanan Developer berbasis cloud. Acquia dirancang agar dapat digunakan bersama Drupal untuk memungkinkan Anda mengembangkan, menguji, dan memublikasikan portal di lingkungan yang aman.
Bagian berikut menjelaskan cara menggunakan Acquia untuk mengembangkan dan mengelola portal Anda.
Mengakses antarmuka Acquia Cloud
Setelah akun Acquia Cloud disiapkan, Anda dapat mengakses portal melalui antarmuka Acquia Cloud di https://cloud.acquia.com/.
Saat pertama kali login, halaman Applications akan ditampilkan, seperti ditunjukkan dalam gambar berikut.
Halaman Aplikasi menampilkan semua aplikasi yang dapat Anda akses, yang dihosting di Acquia Cloud. Aplikasi adalah entity software yang Anda kelola di Acquia Cloud, seperti situs portal berbasis Drupal.
Bagian berikut menjelaskan cara menggunakan antarmuka Acquia Cloud untuk mengelola konten portal Anda.
Untuk informasi selengkapnya tentang antarmuka Acquia Cloud, lihat Login ke antarmuka Acquia Cloud dan Mengelola aplikasi dengan Acquia Cloud dalam dokumentasi Acquia Cloud.
Mengelola lingkungan Anda
Akses antarmuka Acquia Cloud, lalu klik Manage yang terkait dengan situs portal Anda di halaman Applications untuk mengakses dasbornya.
Untuk mengelola alur kerja, tiga lingkungan disediakan untuk mengembangkan, menguji, dan memublikasikan portal Anda, sebagaimana diuraikan dalam tabel berikut. Portal Anda di-deploy ke setiap lingkungan, tetapi mungkin berada dalam status yang berbeda dengan cabang atau tag kode unik, database, dan sebagainya. Lihat Men-deploy kode ke lingkungan portal.
Lingkungan | Deskripsi | URL Default |
Pengembang | Kembangkan fitur baru dan sesuaikan portal Anda. |
http://{application-name}xxxxxx.devcloud.acquia-sites.com/
Dengan |
Tahap | Uji kode terbaru sebelum mengirimkannya ke lingkungan produksi. |
http://{application-name}yyyyyy.devcloud.acquia-sites.com/
Dengan |
Produksi | Publikasikan portal Anda ke produksi (aktif). |
http://{application-name}.devcloud.acquia-sites.com/
Dengan Catatan: Lihat juga Mengonfigurasi domain kustom. |
Untuk mengetahui informasi selengkapnya, lihat Bekerja dengan lingkungan dalam dokumentasi Acquia Cloud.
Mengembangkan portal Anda
Bagian berikut menjelaskan cara mengembangkan portal Anda.
- Ringkasan repositori Git
- Mengakses kode Anda
- Men-deploy kode ke lingkungan portal Anda
- Menambahkan modul dan tema kustom
- Mengganti modul dan tema profil 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
Sebelum dapat menggunakan Git untuk mengelola kode Drupal, Anda harus mengaktifkan SSH untuk mengakses server. Untuk mengetahui informasi selengkapnya, baca artikel Mengaktifkan akses SSH dalam dokumentasi Acquia Cloud.
Untuk mengaktifkan akses SSH:
- Login ke antarmuka Akun Acquia di https://accounts.acquia.com.
- Klik Kedensial.
- Jika diminta, masukkan kembali sandi untuk mengonfirmasi identitas Anda.
- Di bawah kunci SSH, klik Tambahkan kunci SSH.
- Masukkan informasi berikut:
Kolom Deskripsi Nama Nama panggilan untuk kunci SSH. Nama panggilan dapat berisi karakter alfanumerik dan garis bawah. Kunci publik Kunci publik. Untuk informasi tentang cara membuat kunci publik SSH, lihat Membuat kunci publik SSH dalam dokumentasi Acquia Cloud.
- Klik Tambahkan Kunci.
Mengakses repositori kode Anda di Git
Repositori Git berisi semua kode situs portal Anda. Anda dapat menambahkan kode baru atau menyesuaikan kode yang ada untuk mengonfigurasi portal. Untuk informasi selengkapnya, lihat Menggunakan repositori kode dalam dokumentasi Acquia Cloud.
Untuk mengakses repositori kode Anda di repo Git:
- Login ke antarmuka Acquia Cloud di https://cloud.acquia.com/.
- Di halaman Aplikasi, klik Manage untuk melihat detail portal.
- Klik Application Info di menu navigasi.
- Salin perintah clone dalam dialog Informasi Aplikasi.
- Clone repositori Git ke lingkungan lokal Anda dengan menjalankan salah satu perintah Git berikut:
Untuk meng-clone repositori Git dan membuat cabang baru:
> git clone --branch [branch] myportal@abcdef.devcloud.hosting.acquia.com:myportal.git [destination]
Untuk meng-clone repositori Git dari cabang master:
> git clone myportal@abcdef.devcloud.hosting.acquia.com:myportal.git [destination]
- Ulangi langkah-langkah ini jika Anda siap untuk melakukan tahapan, commit, dan mengirim perubahan ke repositori Git menggunakan perintah yang relevan yang ditampilkan di jendela Application.
Saat Anda meng-commit cabang ke repositori Anda, Acquia Cloud akan memperbarui lingkungan yang menjalankan cabang kode tersebut. Anda dapat men-deploy kode ke lingkungan portal, seperti yang dijelaskan di bagian berikutnya.
Men-deploy kode ke lingkungan portal Anda
Untuk men-deploy, mengganti, atau mengembalikan kode di lingkungan portal, memindahkan kode antarlingkungan, atau mempelajari lebih lanjut struktur repositori dan alur kerja yang direkomendasikan, lihat Bekerja dengan situs di Aquia Cloud dalam
dokumentasi Acquia Cloud. Saat men-deploy kode baru ke lingkungan, Anda harus menjalankan update.php
untuk
melakukan pembaruan database yang diperlukan.
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 |
sites/all/modules/contrib
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 |
Mengaktifkan SSL
Untuk mengaktifkan akses aman ke situs Anda menggunakan HTTPS, Anda harus mengaktifkan SSL.
Untuk mengaktifkan SSL:
- Mendapatkan sertifikat SSL dari Certificate Authority (CA) atau vendor sertifikat SSL. Lihat Mengaktifkan SSL.
- Upload sertifikat SSL di halaman SSL di antarmuka Acquia Cloud. Lihat Mengelola sertifikat SSL.
Mengamankan lingkungan produksi Anda
Saat pertama kali membuat aplikasi, Anda dapat dengan bebas mengelola lingkungan produksi dan menerapkan perubahan dari lingkungan pengembangan dan staging. Setelah memublikasikan konten, Anda dapat mengunci lingkungan production untuk mencegah update konten yang tidak sah atau tidak disengaja. Untuk informasi selengkapnya, lihat Menggunakan mode Produksi untuk melindungi aplikasi aktif dalam dokumentasi Acquia Cloud.
Untuk mengamankan lingkungan produksi Anda:
- Login ke antarmuka Acquia Cloud di https://cloud.acquia.com/.
- Di halaman Aplikasi, klik Kelola untuk melihat detail situs portal Anda.
- Klik Prod untuk melihat detail lingkungan produksi.
- Klik Mode Produksi di menu navigasi.
- Klik Aktifkan untuk mengaktifkan mode produksi.
Menerapkan update modul dan tema ke portal
Secara berkala, Apigee mengupdate modul dan tema di portal Anda ke versi terbaru secara otomatis. Update hanya dilakukan untuk lingkungan Dev dan diberi tag untuk menunjukkan bahwa update perlu dimigrasikan ke lingkungan portal lainnya.
Jika situs Anda bukan bagian dari organisasi penagihan Apigee Acquia (misalnya, situs baru yang dimigrasikan dari penyedia hosting lain ke organisasi Anda sendiri), Anda harus mengizinkan Apigee mengakses repositori Git Anda agar dapat menerima push update Devportal otomatis. Hubungi dukungan Apigee untuk mengetahui informasi selengkapnya.
Jika menambahkan modul atau tema kustom, Anda perlu memperbaruinya secara manual.
Tabel berikut merangkum langkah-langkah yang diperlukan untuk menerapkan update modul dan tema ke portal.
Modul/Tema | Deskripsi |
Modul Apigee Edge |
Apigee hanya menerapkan update ke lingkungan Dev. Setelah menguji update, migrasikan update dari lingkungan Dev ke Stage ke Prod, seperti yang dijelaskan dalam Men-deploy kode ke lingkungan portal Anda. |
Tema Responsif Apigee |
Apigee menerapkan update secara otomatis hanya ke lingkungan Dev. Setelah menguji update, migrasikan update dari lingkungan Dev ke Stage ke Prod, seperti yang dijelaskan dalam Men-deploy kode ke lingkungan portal Anda. |
Drupal core dan modul kontribusi |
Apigee menerapkan update secara otomatis hanya ke lingkungan Dev. Setelah menguji update, migrasikan update dari lingkungan Dev ke Stage ke Prod, seperti yang dijelaskan dalam Men-deploy kode ke lingkungan portal Anda. |
Modul dan tema kustom |
Jika Anda telah menambahkan modul dan tema kustom ke portal, seperti yang dijelaskan dalam Menambahkan modul dan tema kustom, Anda harus menginstal update secara manual. Download versi terbaru ke direktori lokal Anda secara manual atau menggunakan Drush. Selanjutnya, lakukan tahap, commit, dan kirim update ke repositori Git. Setelah menguji update, migrasikan update dari lingkungan Dev ke Stage ke Prod, seperti yang dijelaskan dalam Men-deploy kode ke lingkungan portal Anda. |
Memigrasikan fitur kustom
Jika menambahkan kode atau konfigurasi kustom ke portal, Anda harus mengelola dan memigrasikannya dari lingkungan Dev ke Stage ke Prod.
Untuk kode dalam repositori Git, Anda dapat menggunakan proses yang dijelaskan dalam Men-deploy kode ke lingkungan portal untuk memigrasikan kode dari Dev ke Stage ke Prod.
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:
|
Mengonfigurasi domain kustom
Seperti yang dijelaskan dalam Mengelola lingkungan Anda, nama domain default untuk lingkungan portal berakhir pada acquia-sites.com
. Sebaiknya
berikan nama domain kustom Anda sendiri yang mempersonalisasi dan menyampaikan tujuan situs Anda dengan lebih baik. Misalnya, alternatif yang populer adalah:
https://developers.mycompany.com
Untuk mengonfigurasi domain kustom:
- Tambahkan domain Anda ke lingkungan situs portal. Lihat Mengelola domain di dokumentasi Acquia Cloud.
- Siapkan domain kustom bersama penyedia DNS dengan mengarahkan entri data DNS nama domain Anda ke alamat IP publik (bukan ke domain
acquia-sites.com
). Lihat Mengarahkan data DNS ke alamat IP publik Anda dalam dokumentasi Acquia Cloud.Catatan: Jangan tetapkan entri CNAME nama domain ke domain
acquia-sites.com
. Jika dilakukan, hal tersebut dapat menyebabkan masalah latensi atau periode nonaktif untuk situs portal Anda.
Memantau portal menggunakan Acquia Insight
Acquia Insight adalah serangkaian alat yang memungkinkan Anda mengoptimalkan situs portal dengan memantau performa, keamanan, dan pengoptimalan mesin telusurnya. Untuk mengetahui informasi selengkapnya, lihat Acquia Insight.
Mencadangkan portal
Tabel berikut merangkum opsi yang tersedia untuk mencadangkan komponen portal Anda.
Komponen | Detail pencadangan | Info selengkapnya di Dokumen Acquia Cloud |
Code |
|
|
Database |
|
|
Files | Lakukan pencadangan manual atau jadwalkan cron job. | |
Aplikasi lengkap | Lakukan pencadangan manual menggunakan Drush. . |
|
Sistem file Drupal |
Lakukan pencadangan manual menggunakan salah satu opsi berikut:
Catatan: Modul Pencadangan dan Migrasi tidak didukung di Acquia Cloud. Untuk informasi selengkapnya, lihat Modul Pencadangan dan Migrasi yang tidak didukung di Acquia Cloud. |
Melihat notifikasi aktivitas
Anda dapat melihat notifikasi aktivitas untuk memantau tindakan signifikan yang terjadi pada situs portal, seperti kode yang diinstal atau disalin antarlingkungan, update dan pencadangan database, perubahan server, serta sebagainya. Untuk informasi selengkapnya, lihat Melihat notifikasi aktivitas dalam dokumentasi Cloud Acquia.
Untuk melihat daftar notifikasi:
- Login ke antarmuka Acquia Cloud di https://cloud.acquia.com/.
- Di halaman Aplikasi, klik Kelola untuk melihat detail situs portal Anda.
- Klik ikon lonceng di sudut kanan atas menu navigasi untuk melihat notifikasi terbaru Anda.
- Klik panah di samping notifikasi untuk melihat informasi selengkapnya tentang aktivitas tersebut.
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 info terbaru status Acquia untuk menerima notifikasi tentang gangguan layanan, pemeliharaan darurat, atau update keamanan yang dilakukan pada platform. Untuk berlangganan info terbaru Acquia Cloud:
- Buka halaman Status Acquia.
- Klik Berlangganan Pembaruan.
- Pilih metode yang ingin Anda gunakan untuk menerima info terbaru (email, SMS, dan sebagainya).
- Di halaman Notifikasi, pilih produk yang ingin Anda terima pembaruan statusnya. Misalnya, Acquia Cloud Enterprise.
- Klik Update Preferences.