Bekerja dengan Acquia

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 application-name adalah nama aplikasi Anda dan xxxxxx adalah string karakter unik yang digunakan untuk membedakan Dev dan Stage.

Tahap Uji kode terbaru sebelum mengirimkannya ke lingkungan produksi. http://{application-name}yyyyyy.devcloud.acquia-sites.com/

Dengan application-name adalah nama aplikasi Anda dan yyyyyy adalah string karakter unik yang digunakan untuk membedakan Dev dan Stage.

Produksi Publikasikan portal Anda ke produksi (aktif). http://{application-name}.devcloud.acquia-sites.com/

Dengan application-name adalah nama aplikasi Anda.

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.

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:

  • /profiles/apigee/modules/contrib: Modul contrib Drupal yang dikelola oleh Apigee
  • /profiles/apigee/themes/contrib: Tema contrib Drupal yang dikelola oleh Apigee
  • /profiles/apigee/modules/custom: Modul kustom yang dibuat oleh Apigee
  • /profiles/apigee/themes/custom: Tema kustom yang dibuat oleh Apigee

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:

  1. Login ke antarmuka Akun Acquia di https://accounts.acquia.com.
  2. Klik Kedensial.
  3. Jika diminta, masukkan kembali sandi untuk mengonfirmasi identitas Anda.
  4. Di bawah kunci SSH, klik Tambahkan kunci SSH.
  5. 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.

  6. 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:

  1. Login ke antarmuka Acquia Cloud di https://cloud.acquia.com/.
  2. Di halaman Aplikasi, klik Manage untuk melihat detail portal.
  3. Klik Application Info di menu navigasi.

  4. Salin perintah clone dalam dialog Informasi Aplikasi.
  5. 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]

  6. 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 /sites/all/modules akan mengganti modul distribusi Apigee Drupal.

Modul kontribusi

Catatan: Modul kontribusi Drupal dalam direktori ini menggantikan modul setara yang dikelola dan didistribusikan oleh Apigee di /profiles/apigee/modules. Hapus semua modul duplikat yang Anda tambahkan ke folder ini jika ingin menggunakan modul profil Drupal yang dikelola Apigee.

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 /profiles/apigee/themes. Hapus semua modul duplikat yang Anda tambahkan ke folder ini jika ingin menggunakan tema profil yang dikelola Apigee.

Mengaktifkan SSL

Untuk mengaktifkan akses aman ke situs Anda menggunakan HTTPS, Anda harus mengaktifkan SSL.

Untuk mengaktifkan SSL:

  1. Mendapatkan sertifikat SSL dari Certificate Authority (CA) atau vendor sertifikat SSL. Lihat Mengaktifkan SSL.
  2. 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:

  1. Login ke antarmuka Acquia Cloud di https://cloud.acquia.com/.
  2. Di halaman Aplikasi, klik Kelola untuk melihat detail situs portal Anda.
  3. Klik Prod untuk melihat detail lingkungan produksi.
  4. Klik Mode Produksi di menu navigasi.
  5. 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:

  • Tambahkan fungsi hook_update_N() ke file .install modul untuk memproses perubahan Anda.
  • Deploy perubahan ini bersama dengan kode Anda.
  • Jalankan update.php untuk memigrasikan perubahan di lingkungan Stage dan Prod.

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:

  1. Tambahkan domain Anda ke lingkungan situs portal. Lihat Mengelola domain di dokumentasi Acquia Cloud.
  2. 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
  • Kode dikelola oleh sistem kontrol versi dan diberi tag setiap kali Anda melakukan commit.
  • Sinkronkan atau kembali ke tag tertentu kapan saja.
Database
  • Pencadangan harian dilakukan dan dikelola selama tiga hari.
  • Menjadwalkan pencadangan otomatis dan sesuai permintaan.
  • Snapshot bencana internal dari semua data diambil setiap jam.
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:
  • Salin file Anda menggunakan klien FTP atau alat command line (rsync dan scp).
  • Buat arsip terkompresi menggunakan Drush.

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:

  1. Login ke antarmuka Acquia Cloud di https://cloud.acquia.com/.
  2. Di halaman Aplikasi, klik Kelola untuk melihat detail situs portal Anda.
  3. Klik ikon lonceng di sudut kanan atas menu navigasi untuk melihat notifikasi terbaru Anda.

  4. 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:

  1. Buka halaman Status Acquia.
  2. Klik Berlangganan Pembaruan.
  3. Pilih metode yang ingin Anda gunakan untuk menerima info terbaru (email, SMS, dan sebagainya).
  4. Di halaman Notifikasi, pilih produk yang ingin Anda terima pembaruan statusnya. Misalnya, Acquia Cloud Enterprise.
  5. Klik Update Preferences.