全部产品
Search
文档中心

Cloud Shell:Tulis sebuah tutorial

更新时间:Jun 30, 2025

Anda dapat menulis tutorial di Cloud Shell dan mempublikasikannya ke repositori Git jarak jauh. Pengguna dapat membaca tutorial tersebut untuk mulai menggunakan proyek Anda.

Dalam mode tutorial Cloud Shell, pengguna dapat mengklik baris perintah dalam dokumentasi untuk menjalankannya langsung di Cloud Shell.

Langkah 1: Buat file tutorial

Untuk membuat file tutorial, ikuti langkah-langkah berikut:

  1. Buat folder di Cloud Shell untuk menyimpan file tutorial.

    Contoh

    mkdir tutorials
  2. Buat file Markdown di direktori root folder. Sebagai contoh, jalankan perintah berikut untuk membuat file tutorial.md:

    touch tutorial.md

Langkah 2: Tulis sebuah tutorial

Anda dapat menulis tutorial menggunakan sintaks Markdown. Saat menulis tutorial, perhatikan aturan berikut:

  • Gunakan tanda pagar (#) untuk membuat judul tingkat 1. Judul tingkat 1 adalah judul dari tutorial. Anda hanya dapat membuat satu judul tingkat 1 dalam sebuah tutorial.

  • Gunakan dua tanda pagar (##) untuk membuat judul tingkat 2. Judul tingkat 2 adalah judul dari sebuah langkah.

  • Tulis kode menggunakan sintaks Markdown. Cloud Shell akan merender kode Anda menjadi blok kode yang memiliki ikon Eksekusi di tutorial. Pengguna dapat mengklik ikon Eksekusi pada blok kode untuk menyalinnya ke editor Cloud Shell.

    ```bash
    aliyun help
    ```    
  • Gunakan instruksi direktori berikut dari Cloud Shell untuk menghasilkan struktur direktori untuk tutorial Anda:

    <tutorial-nav></tutorial-nav>
  • Gunakan instruksi buka file berikut dari Cloud Shell untuk menambahkan tautan file ke tutorial Anda. Pengguna dapat mengklik tautan dalam tutorial untuk membuka file yang ditunjuk oleh tautan tersebut di editor Cloud Shell.

    <tutorial-editor-open-filefilePath="path/test.md>Buka File</tutorial-editor-open-file>

    Untuk menambahkan tautan file ke tutorial Anda, simpan file di direktori $HOME atau subdirektori dari $HOME. Anda dapat mengatur filePath dalam instruksi ke jalur absolut atau relatif dari file. Jalur relatif menentukan lokasi file relatif terhadap $HOME.

Kode sampel berikut memberikan contoh cara membuat tutorial. Anda dapat menggunakan editor Vim atau editor Cloud Shell untuk menulis tutorial Anda.

# Gunakan Alibaba Cloud CLI untuk mengelola sumber daya cloud.

## Lihat informasi bantuan Alibaba Cloud CLI.
```bash
aliyun help
```
### Pertama
Catatan
### Selanjutnya
Catatan
```bash
echo world
```
## Selamat! Anda telah menyelesaikan tutorial!
Selamat! Anda telah menyelesaikan tutorial tentang cara menggunakan Alibaba Cloud CLI!

Langkah 3: Publikasikan tutorial

Untuk mempublikasikan tutorial, ikuti langkah-langkah berikut:

  1. Sebelum mempublikasikan tutorial, jalankan perintah berikut untuk mengujinya:

    teachme tutorial.md
  2. Setelah tutorial Anda lulus pengujian, jalankan perintah git push Cloud Shell untuk mengunggah tutorial Anda dari repositori Git lokal ke repositori Git jarak jauh. Folder tempat Anda menyimpan tutorial adalah repositori Git lokal.

    Catatan

    Unggah tutorial Anda ke repositori jarak jauh yang dapat diakses melalui Internet. Jika tidak, pengguna yang membaca tutorial Anda mungkin tidak dapat mengkloning repositori jarak jauh ke Cloud Shell.