금요일 해킹부터 출시까지: 오픈 소스 프로젝트 생성 및 출시에 대한 고찰-Golang-php.cn

From Friday Hack to Release: Reflections on Creating and Releasing a Open Source Project

금요일 패치 해킹부터 출시까지: 오픈소스 프로젝트 생성 및 출시에 대한 고찰

초보 및 중급 개발자를 대상으로 자신의 아이디어를 오픈 소스 프로젝트로 공개하거나 관심을 갖는 시리즈의 일부입니다.
이러한 반성은 편향적이고 개인적입니다. 더 많은 기사가 예정되어 있습니다. 몇 가지 생각을 공유함으로써 여러분이 자신의 프로젝트를 수행하는 데 영감을 주기를 바랍니다

반성(이것)
Java 개발자로서 Go 언어 배우기(TODO)
오픈 소스 건강 및 커뮤니티 파일(TODO)
오픈소스 보안(TODO)

요구 사항

모든 것은 몇 년 전에 시작되었습니다. 때때로 나는 나 또는 다른 사람이 항상 똑같은 Bash 스크립트를 다시 만드는 것과 관련된 것처럼 보이는 무언가가 필요했습니다.
전반적인 요구 사항은 높은 수준인 경우가 많기 때문에 간단했습니다.
우리 개발자들이 주로 하는 일은 A지점에서 B지점으로 정보를 섞는 것 뿐입니다. 그렇죠?

여기서 목표는 여러 Git 저장소를 다른 Git 제공자, 디스크, 아카이브 형식, CLI 앱으로 미러링하는 것이었습니다.
나는 개인적으로나 직장에서 이것이 필요했습니다. 사람들이 이런 일을 수동으로 처리하는 데 많은 시간을 투자하는 것을 보니 마음이 불편합니다.

그래도 항상 단순한 Bash 스크립트로 유지되는 것 같았습니다. 신속하게 완료되지만 특별한 경우, 오류 처리, 모듈화, 패키징 등 추가 사항이 추가되어야 하는 경우 - 우리 대부분이 동의하는 것처럼 Bash 스크립트는 더 큰 도구를 지원하지 않습니다.

그래서 이를 위한 완전한 CLI 애플리케이션을 만들기로 결정했습니다.

사전 결정

그러한 도구가 이미 존재합니까?

가장 먼저 해야 할 일은 바퀴를 재발명하지 않는 것이었습니다.
오픈 소스로 이 문제를 해결하는 몇 가지 도구가 있습니다. Go로 작성된 최소한 하나, Bash 스크립트 몇 개, 그리고 Gitea와 같은 가져오기 기능을 포함하는 경우.
나는 그것들을 시험해 보았지만 내가 원하는 방식으로 완전히 작동하는 것을 찾을 수 없었습니다. 그리고 프로젝트를 어디로 진행하고 싶은지에 대한 다른 생각이 있었기 때문에 깊이 들어가지 않기로 결정했습니다
기존 프로젝트에 패치를 적용하기 시작했습니다.

상업적인 도구도 몇 가지 있지만, 이 작은 도구는 오픈소스 형태로도 존재해야 한다고 느꼈습니다.

결론: 이 세상에는 이 CLI 도구가 있을 곳이 있었습니다.

Work-hackdays나 개인적인 자유 시간에 해킹을 하시나요?

스프린트가 끝날 때나 다른 경우에는 직장에서 해킹 시간을 가집니다. 한 가지 접근 방식은 시간이 지남에 따라 이러한 상황에서 이를 해킹하여 유용한 것으로 만드는 것입니다.
나는 다음과 같은 이유로 개인 여가 시간에 완전히 하기로 빨리 결정했습니다.

직장에서의 해킹 기회는 전체 프로젝트를 장기간 진행하는 것이 아니라 짧은 학습과 창의성을 발휘하는 데 사용해야 합니다.
해당 솔루션이 핵심 조직의 비즈니스에 적합하지 않습니다. 그렇다면 항상 이상한 일이 될 것입니다.
업무에 연결하면 더 많은 일을 하는 것처럼 느껴질 것입니다. 저는 재미를 위해 이 일을 하며 바둑 등을 배우고 있습니다. 그러면 나에게 압박감과 스트레스가 가해질 것입니다.
업무 시간에 작업을 수행하면 시간이 오래 걸릴 것입니다. 몇 시간, 몇 주에 걸쳐 진행됩니다.

결론: 남는 시간에 재미있게 해야겠다.

기술 스택 선택

저는 JS/TS, Python/Ruby에서 몇 가지 프로젝트를 진행하면서 수년 동안 Java/Kotlin 세계에서 대부분의 시간을 보냈으며 모든 수석 개발자와 마찬가지로 때때로 다른 작업도 하기도 했습니다.
하지만 오랫동안 저는 Go나 Rust를 정말 배우고 싶었습니다. 그래서 새로운 언어에 뛰어들 수 있는 동기를 얻을 수 있는 기회가 될 것입니다
Go를 선택한 이유는 Open Source DevOps 세계의 꽤 많은 CLI 애플리케이션이 Go로 작성되어 있고, 때때로 타사 프로젝트에 패치를 제출할 수 있기를 원하기 때문입니다. 또한 Go로 작성한다는 것은 여러 대상 아키텍처가 포함된 하나의 바이너리를 의미합니다.

예를 들어 Pico CLI 및 GraalVM을 사용하면 Java에서 이 작업을 수행할 수 있었는데, 이전 시도 이후 좋은 인상을 받았지만 대신 Go를 배우고 싶다고 결정했습니다.

결론: Go로 해보고 배워야겠습니다.

기타 학습 목표

이를 통해 대부분의 보안 관행(스코어카드, SLSA,

)을 따라 멋지게 패키지된 오픈 소스 프로젝트를 제공하는 주제에 대해 더 깊이 탐구하고 싶었습니다. GoRelease와 같은 도구를 사용하여 다양한 종류의 빌드를 만들 수 있습니다.

결론: 원하는 주제를 배우고 탐구할 수 있는 기회를 가져보세요.

Kekalkan Skop

Memandangkan saya merancang untuk banyak bereksperimen dan saya benar-benar baru dalam Go, saya tahu saya akan melakukan banyak kerja tidak berstruktur.
Di sini adalah penting untuk menetapkan skop - bilakah ia cukup bagus untuk keluaran alfa?
Saya pada awalnya memutuskan fungsi yang sepatutnya ada, dan walaupun menggoda untuk duduk dan memperhalusi dan mengembangkannya lagi, ini bagus.
Saya boleh duduk dengan ini untuk masa yang lama.

Kesimpulan: Lepaskan projek sebagai alpha apabila anda sama-sama malu dan bangga dengannya.

Anggaran - Sejauh Mana Sukarnya?

Mempelajari bahasa baharu ialah sebahagian kecil daripada mempelajari bahasa itu sendiri, tetapi lebih banyak lagi tentang mempelajari ekosistem dan simpulan bahasanya.
Apakah perpustakaan yang digunakan, bagaimana ia digunakan, apakah cara idiomatik untuk melakukan ini dan itu?
Saya perlu menghabiskan banyak masa untuk belajar dan menyelidik semasa projek ini, mungkin 50% daripada masa saya akan
telah menghabiskan hanya pengekodan dalam bahasa dan ekosistem yang saya tahu.

Kesimpulan: Gandakan anggaran masa anda dengan tiga apabila mempelajari susunan teras baharu dan melibatkan percubaan. Sintaks bahasa akan menjadi perkara kecil.

Proses Penciptaan

Komitmen Awal

Pelaksanaan asas dilakukan dalam sehari - ia tidak mempunyai binaan, pengendalian ralat, dokumentasi, kes tepi, kebolehselenggaraan, dsb.
Di sinilah kebanyakan penggodaman pada hari Jumaat berakhir, dan kebanyakannya tidak pernah pergi lebih jauh.

Tetapi seperti yang diketahui oleh semua pembangun kanan, membuat sesuatu berfungsi adalah jauh daripada mengeluarkan produk.

Tak lama lagi, eh? Tidak juga.

Mencari Masa

Ada kalanya sukar mencari masa untuk meluangkan masa dengan projek itu, terutamanya kerana saya mempunyai musim bunga yang meletihkan di tempat kerja.
Bukan setiap malam anda berasa seperti membaca buku selama 2 jam tentang sesuatu yang khusus atau mempelajari teknologi baharu.
Atau menghabiskan masa menulis dokumentasi. Saya mempunyai anak dan rumah, dan saya tidak mampu untuk membiarkan projek persendirian memakan diri saya lebih daripada hobi lain.
Tetapi sesuatu yang sentiasa perlu diberikan - Saya akhirnya menonton lebih sedikit siri, dan sebarang permainan hampir tidak wujud dalam tempoh ini.

Dengan itu, walaupun saya berharap saya dapat meluangkan lebih banyak masa pada projek itu, ia hampir selalu memberi motivasi - Saya mempunyai beberapa sesi malam di mana saya kurang tidur dan berkod atau belajar,
kerana saya sangat teruja untuk pergi lebih jauh. Selain itu, apabila sesuatu yang menyeronokkan, ia adalah menyeronokkan, sama ada mengangkat berat, menulis buku, mengembangkan, dsb.

Perkara yang Saya Lupa

Saya sudah terbiasa bekerja dalam pasukan sejak sekian lama. Dengan projek solo, anda perlu menguruskan lebih banyak topi dan menjadi agak baik dalam setiap bahagiannya, tidak selalunya teknikal.
Saya menghabiskan banyak masa untuk menggali reka bentuk CLI yang baik dan pilihan idiomatik. Bidang lain ialah proses pelepasan dan binari binari untuk platform yang berbeza.
Mengikuti SLSA dan piawaian lain dalam Sumber Terbuka juga mengambil masa. Dan kami mahukan liputan ujian yang baik, bukan?
Bekerja dalam satu pasukan, orang lain diharapkan dapat melakukan logo yang anda mahukan, dokumentasi yang perlu ditulis.
Bekerja solo, itu hanya anda atau ia tidak akan berlaku.
Menulis kod tidak sampai 50% daripada menyampaikan projek. Dan ada yang lain.

Sindrom Penipu Melanda

Sindrom Penipu adalah perkara biasa dalam dunia pembangun berasaskan pengetahuan kami. Setiap orang mempunyai kemahiran yang berbeza, dan pada bila-bila masa, akan sentiasa ada seseorang yang lebih tahu daripada anda.
Berada dalam satu pasukan, anda mempunyai seseorang untuk berbincang.
Sendiri, tidak sebanyak.

Tetapi, ini semua tentang menerima bahawa seseorang akan melakukan beberapa perkara bodoh dalam kod pada masa-masa tertentu.
Dan, Sumber Terbuka itu bukan tentang menjadi sempurna. Ini tentang belajar, menyelesaikan dan melepaskan perkara yang mungkin berguna kepada orang lain.

The Grind

Nah, apa yang boleh saya katakan - ia dilakukan apabila ia selesai.

Terdapat beberapa waktu penyahpepijatan lewat malam, pemfaktoran semula, tetapi juga detik aliran dan dopamin yang tidak terkira banyaknya.

Bagi saya, masa keluaran tiba apabila saya merasakan seni bina keseluruhan dalam projek tidak akan bergerak secara radikal - saya telah mengenal pasti antara muka dan merasakan ia boleh dilanjutkan.
Pangkalan kod OK.
Kebanyakan ciri asas ada dan sementara segala-galanya disediakan untuk penambahbaikan, ia masih menjadi asas untuk diusahakan.

Kesudahan dan Pengajaran

Tetapkan skop awal: Tentukan tempat untuk berhenti. Sediakan struktur projek, dokumentasi, keluaran, saluran paip dan garis panduan komuniti anda lebih awal. Masa depan anda akan berterima kasih kepada anda.
Jangan stress, nikmati proses pembelajaran: Ia dilakukan apabila ia selesai.
Tekun: Sumber terbuka ialah maraton, bukan pecut. Jangan burn out. Ia adalah hobi, bukan kehidupan anda. Namun tetap gigih. Lakukan perkara kecil setiap hari.
배우고, 배우고, 배우세요: 모든 것을 문제가 아닌 학습과 발전의 기회로 여기세요.
코딩은 쉬운 부분입니다. 메인 코드는 시간이 가장 적게 걸리는 코드입니다. 문서화, 테스트 등과 같은 다른 모든 작업에 시간이 소요됩니다.
추가 기능 수행: 코딩만큼 재미있습니다. 예, 문서화를 통해 설명하고 다시 설명하는 데 드는 시간을 절약할 수 있습니다. 지루하다면 재미있게 만드십시오. Docs-as-code, vim-pong 등
휴식을 취하세요. 번아웃은 현실입니다. 필요할 때 뒤로 물러서세요. 다른 모든 창의적인 학습 과정과 마찬가지로 일괄적으로 진행하세요.
시스템 사용: 가능한 한 빨리 실제와 현실 세계에서 나만의 dogfood를 사용하세요. 더 나은 방법은 피드백을 제공할 사람/커뮤니티를 찾는 것입니다.
여행을 즐겨보세요. 만드는 것은 멋진 일입니다.
완료: 이 세상에는 반만 완료된 프로젝트가 엄청나게 많습니다. 완성하세요.
AI를 도움으로 사용: 코드 개선, 코드 검토, 문서 구조, 요약 등과 같은 약간의 추가 작업을 AI에 위임하여 시간을 절약합니다. 맹목적으로 믿으십시오. 답변을 검토하고 비판하세요.