Skip to main content

Panduan irgsh-cli untuk Pemaket

GPG​

Kebutuhan​

  • apt install gnupg build-essential devscripts debhelper lintian dch

Generate​

gnupg --full-generate-key

Dalam proses akan ditanyakan informasi entitas dan kunci, contoh:

gpg (GnuPG) 2.2.20; Copyright (C) 2020 Free Software Foundation, Inc.
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.arsip-dev.blankonlinux.or.id/

Please select what kind of key you want:
   (1) RSA and RSA (default)
   (2) DSA and Elgamal
   (3) DSA (sign only)
   (4) RSA (sign only)
  (14) Existing key from card
Your selection? 1
RSA keys may be between 1024 and 4096 bits long.
What keysize do you want? (3072) 4096
Requested keysize is 4096 bits
Please specify how long the key should be valid.
         0 = key does not expire
      <n>  = key expires in n days
      <n>w = key expires in n weeks
      <n>m = key expires in n months
      <n>y = key expires in n years
Key is valid for? (0) 5y
Key expires at Thu 20 Nov 2025 07:49:07 PM WIB
Is this correct? (y/N) y

GnuPG needs to construct a user ID to identify your key.

Real name: Herpiko Dwi Aguno
Email address: herpiko@gmail.com
Comment:
You selected this USER-ID:
    "Herpiko Dwi Aguno <herpiko@gmail.com>"

Change (N)ame, (C)omment, (E)mail or (O)kay/(Q)uit? O
We need to generate a lot of random bytes. It is a good idea to perform
some other action (type on the keyboard, move the mouse, utilize the
disks) during the prime generation; this gives the random number
generator a better chance to gain enough entropy.
oienienoienoienoienoienoienoienoienoienoienoienoiengpg: key F73403755814255E marked as ultimately trusted
gpg: directory '/home/herpiko/.gnupg/openpgp-revocs.d' created
oienoiegpg: revocation certificate stored as '/home/herpiko/.gnupg/openpgp-revocs.d/4E1C6A31FB1DF66463806857F73403755814255E.rev'
public and secret key created and signed.

pub   rsa4096 2020-11-21 [SC] [expires: 2025-11-20]
      4E1C6A31FB1DF66463806857F73403755814255E
uid                      Herpiko Dwi Aguno <herpiko@gmail.com>
sub   rsa4096 2020-11-21 [E] [expires: 2025-11-20]

Lihat kunci yang sudah dibikin dengan,

gnupg -K

Ekspor​

Salin terlebih dahulu identitas kuncinya. Lihat identitas kunci yang ada dengan perintah gpg -K. Outputnya:

/home/herpiko/.gnupg/pubring.kbx
--------------------------------
sec   rsa4096 2020-11-21 [SC] [expires: 2025-11-20]
      4E1C6A31FB1DF66463806857F73403755814255E
uid           [ultimate] Herpiko Dwi Aguno <herpiko@gmail.com>
ssb   rsa4096 2020-11-21 [E] [expires: 2025-11-20]

Di kasus output di atas, identitas kuncinya adalah 4E1C6A31FB1DF66463806857F73403755814255E.

Kemudian coba ekspor kunci publiknya dengan perintah,

gpg --armor --export 4E1C6A31FB1DF66463806857F73403755814255E > namapemaket-gpg-pubkey

Sampai di sini, kuncinya dapat diserahkan ke tim infra untuk disuntikkan ke GPG keystore irgsh.

Hapus​

Menghapus kunci cukup dengan perintah,

gpg --delete-key 4E1C6A31FB1DF66463806857F73403755814255E

Pendaftaran kunci pemaket ke irgsh​

Bagian ini dilakukan oleh Tim Infra.

  • Bawa kunci-kunci yang mau diimpor ke mesin irgsh, misal dengan scp
  • Masuk ke user irgsh
  • Impor dengan perintah gpg --import < /path/to/pub.key
  • Setelah diimpor, pastikan kuncinya terdaftar dengan perintah gpg --list-key

Untuk menghapus kunci (misal pemaket sudah mengundurkan diri),

  • Cari ID kuncinya dari gpg --list-key
  • Hapus dengan perintah gpg --delete-key IDKUNCI, misal
gpg --delete-key 2241430595AAE28DA3352AACA2DFD68CA9E2F65A
gpg (GnuPG) 2.2.12; Copyright (C) 2018 Free Software Foundation, Inc.
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.


pub  rsa4096/A2DFD68CA9E2F65A 2021-06-16 RedactedName <redacted.name@gmail.com>

Delete this key from the keyring? (y/N) y

irgsh-cli​

Kebutuhan​

  • Turunan Debian
  • apt install gnupg curl jq tar build-essential devscripts debhelper

Pemasangan​

Pasang irgsh-cli dengan perintah satu baris berikut,

curl -L -o- https://raw.githubusercontent.com/BlankOn/irgsh-go/master/install-cli.sh | bash

Bila sudah selesai, akan tampil output seperti di bawah ini yang menandakan irgsh-cli siap dipakai,

/tmp /tmp
Extracting ...
Extracting [OK]

Installing files ...
'/tmp/irgsh-go/usr/bin/irgsh-cli' -> '/usr/bin/irgsh-cli'
Happy hacking!

Konfigurasi awal​

Sebelum mengkonfigurasi irgsh-cli, pemaket perlu mengkonfirmasi ke Tim Infra di mana irgsh-chief (induk dari komponen-komponen irgsh) dinyalakan. Dalam lokakarya ini, induk irgsh hidup di https://irgsh.blankonlinux.or.id.

Kemudian konfigurasikan irgsh-cli dengan perintah berikut,

irgsh-cli config --chief https://irgsh.blankonlinux.or.id --key 4E1C6A31FB1DF66463806857F73403755814255E

Sampai di sini, irgsh-cli akan bekerja dengan induk irgsh https://irgsh.blankonlinux.or.id menggunakan kunci pemaket 4E1C6A31FB1DF66463806857F73403755814255E.

Pemaketan dengan irgsh-cli​

Pemaket membutuhkan setidaknya 2 hal untuk memaketkan paket ke irgsh, yaitu:

Keduanya didefinisikan dengan URL lumbung kode (bisa dari mana pun yang penting dapat diakses oleh internet dan sifatnya publik).

Misal kita akan mencoba untuk memaketkan bromo-theme dengan bahan di bawah ini:

Setelah keduanya disiapkan, pemaket dapat menyuntikkan paket ke irgsh dengan perintah berikut,

irgsh-cli submit --source https://github.com/blankon/bromo-theme --package https://github.com/blankon-packages/bromo-theme --experimental

Flag --experimental menandakan paket ini akan disuntikkan ke lumbung experimental alih-alih ke lumbung pengembangan resmi. Tujuannya untuk uji coba sebelum benar-benar dipaketkan ke lumbung.

Lumbung BlankOn​

Lumbung pengembangan resmi terletak di arsip-dev.blankonlinux.or.id. Untuk paket experimental akan disuntik ke arsip-dev.blankonlinux.or.id/experimental, sementara paket resmi masuk ke arsip-dev.blankonlinux.or.id/dev.

Lumbung experimental digunakan oleh pemaket ketika menguji suatu paket. Pemaket harus memastikan bahwa aplikasi yang dipaketkan berhasil dibuat di lumbung ini. Jika sudah dipastikan sukses (bisa dicek hasilnya di sini), maka paket tersebut boleh disuntikkan ke lumbung dev.

Ketika paket sudah masuk ke lumbung dev, paket tersebut akan kembali diuji. Pengembang harus bisa memastikan bahwa paket tersebut berjalan sesuai harapan, baik itu sukses dipasang, sukses diupgrade, maupun sukses dihapus.

Memantau proses pembangunan paket​

Untuk memantau proses pembangunan paket, gunakan perintah berikut:

irgsh-cli log

Atau dengan membubuhkan id pipeline,

irgsh-cli log 2020-11-21-205136_b8dbbd86-0ee1-409a-b3e3-4ec4d97c5302

Panduan lebih detail mengenai pemaketan dengan irgsh-cli dapat disimak di https://github.com/BlankOn/wiki/blob/master/TimPengembang/Pemaket/PanduanPemaketanMenggunakanIrgshCli.md