اسان هڪ منصوبو لکي رهيا آهيون. اسپرنگ بوٽ شامل ڪريو ۽ سي آءِ پروسيس قائم ڪريو - "جاوا پروجيڪٽ A کان Z تائين"

جاوا پروجيڪٽ ٺاهڻ بابت هڪ سيريز مان هڪ مضمون (ٻين مواد جي لنڪ آخر ۾ آهن). ان جو مقصد اهم ٽيڪنالاجي جو تجزيو ڪرڻ آهي، نتيجو هڪ ٽيليگرام بوٽ لکڻ آهي. سلام، پيارا پڙهندڙ. جيئن اڳئين حصي ۾ بيان ڪيو ويو آهي، اسان منصوبي جي مطابق ڪنداسين. اسان اڳ ۾ ئي هڪ پروجيڪٽ ٺاهي ڇڏيو آهي ۽ اهو وقت آهي ڪوڊ سان ڀرڻ جو. ھاڻي سڀئي مسئلا الڳ ڪمن جي طور تي شامل ڪيا ويندا. مان هتي هر شيءِ جو بيان ڪندس جيڪو ضروري آهي. جيڪڏهن مون کي ڪجهه ياد اچي يا ان کي واضح طور تي بيان نه ڪيو، تبصرن ۾ پڇو، مان جواب ڏيڻ جي ڪوشش ڪندس.

اسان لکون ٿا JRTB-0M

هن ڪم ۾ اسان کي مستقبل جي ڪم لاءِ خالي اسپرنگ بوٽ فريم ورڪ شامل ڪرڻو پوندو. اسان اهو ساڳيو طريقي سان ڪنداسين جيئن اسان SpringBoot + Flyway بابت مضمون ۾ ڪيو هو . پروجيڪٽ ڊائونلوڊ ڪريو ، ان کي IDEA ۾ کوليو ۽ JRTB-0 نالي هڪ نئين برانچ ٺاهيو . مون بيان ڪيو ته اهو ڪيئن ڪجي هتي هڪ خيال ذريعي . اهو اسان لاءِ مستقبل ۾ ڪم کي ٽريڪ ڪرڻ آسان بڻائيندو. ڇا توهان اڳ ۾ ئي ڄاڻو ٿا ته هاڻي ڪو ماسٽر برانچ ناهي ؟ هاڻي ان کي سڏيو ويندو آهي غير جانبدار مکيه . تنهنڪري اسان کي ان جي عادت آهي. جيتوڻيڪ، ايماندار ٿيڻ لاء، اسان هميشه ان کي ماسٽر ڏانهن واپس ڪري سگھون ٿا. اسان وڃون ٿا Spring Initializr ۽ اسان جي بوٽ لاءِ اسپرنگ بوٽ فريم ورڪ ٺاھيو. هن وقت، پيش ڪيل بوٽ اسپرنٽ جو ننڍڙو نسخو 2.3.7 آهي، اچو ته ان کي وٺو. مان هيٺ ڏنل سيٽنگن کي الڳ الڳ بيان ڪندس.

• پروجيڪٽ: Maven پروجيڪٽ - اسان اڳ ۾ ئي بحث ڪيو آهي Maven هتي ۽ هتي . تنهن ڪري، مان اضافي طور تي صرف بيان ڪندس جيڪو مون اڳئين مضمونن ۾ ظاهر نه ڪيو هو. جيڪڏهن اهڙا آهن "اڇا اسپاٽ"، يقينا)
• ٻولي: Java - هتي سڀ ڪجهه واضح آهي. جيڪڏهن ڪا خواهش آهي ته اسان هن معاملي کي ڪوٽلن ۾ ٻيهر لکي سگهون ٿا. مون صرف پاڻ لاءِ هڪ ڪتاب ڪوٽلن ان ايڪشن خريد ڪيو آهي، اسان گڏجي ڪوٽلن سکنداسين))
• اسپرنگ بوٽ: 2.3.7 - اسان ڪنهن به مسئلن کي ختم ڪرڻ لاءِ پيش ڪيل ننڍڙو نسخو وٺون ٿا. هي اڳ ۾ ئي بوٽ جو هڪ مڪمل جديد نسخو آهي.

پروجيڪٽ ميٽا ڊيٽا:

• گروپ: com.github.javarushcommunity - هتي اسان اهو ڊومين چونڊيو آهي جنهن تي اسان جي ذخيرن جو گروپ ميزبان آهي.
• آرٽيڪل: javarush-telegrambot - منصوبي جي وڌ ۾ وڌ وضاحت.
• نالو: Javarush TelegramBot - اسان ان کي مڪمل طور تي هتي لکنداسين.
• تفصيل: Telegram bot Javarush لاءِ ڪميونٽي کان ڪميونٽي تائين - هتي منصوبي جي وڌيڪ تفصيلي وضاحت آهي.
• پيڪيج جو نالو: com.github.javarushcommunity.jrtb - هتي توهان اڳ ۾ ئي منصوبي جي نالي لاءِ مخفف استعمال ڪري سگهو ٿا. هاڻي منصوبي جي شروعات هن پيڪيج سان ٿيندي. ايترا گهڻا ڇو؟ تنهن ڪري جڏهن اسان ٻين منصوبن کي ڪلاس پاٿ ۾ شامل ڪنداسين، اهي مختلف پيڪيجز ۾ هوندا. هر هڪ پنهنجي منفرد انداز ۾. اهو ضروري آهي ته OOP اصولن کي برقرار رکڻ لاء.
• پيڪنگنگ: جار اسان جو معيار آهي)
• جاوا: 11 - اسان هڪ قدم اڳتي هونداسين. مان نه ٿو سمجهان ته مان اٺين جاوا کان پوءِ جدت استعمال ڪندس، پر ٿيڻ ڏيو. هو ماني لاءِ نه ٿو پڇي)... اهو فيصلو اسان کي مستقبل ۾ هڪ ننڍڙو ايسٽر انڊي ڏيندو)

اسان في الحال ڪوبه انحصار شامل نه ڪنداسين. اسان کي هن ڪم جي ضرورت ناهي. اهو سڀ ڪجهه ڀرڻ کان پوءِ، اسان حاصل ڪريون ٿا (هتي ٺاهيل پروجيڪٽ جي لنڪ آهي): ڀرڻ کان پوءِ، ڪلڪ ڪريو GENERATE ۽ شامل ڪريو سڀ اندروني شيون آرڪائيو ۾ اسان جي پروجيڪٽ ۾. پروجيڪٽ ۾ فائلون شامل ڪريو. نتيجي طور، اسان وٽ هڪ درخواست آهي. چيڪ ڪرڻ لاءِ ته ڇا اهو مڪمل طور تي گڏ ٿيل آهي، ٽرمينل ڏانهن وڃو ۽ لکو: $ mvn صاف پيڪيج جيڪڏهن توهان وٽ هتي کان ساڳيو آهي، سڀ ڪجهه ٺيڪ آهي: پروجيڪٽ گڏ ڪيو ويو آهي، ۽ جارنڪ اڳ ۾ ئي ٽارگيٽ فولڊر ۾ تيار آهي. هن نقطي تي، تفصيل اندر ڪم تيار آهي. اهو سادو آهي، صحيح؟ تنهن ڪري، اسان عزم ڪريون ٿا ۽ اسان جي شاخ ڏانهن ڌڪيو: اسان ڪمٽ جي وضاحت جي شروعات ۾ اسان جي ڪم جو نالو شامل ڪيو، ته جيئن بعد ۾ اهو واضح ٿئي ته ڪهڙي ڪم جي فريم ورڪ ۾ ڪم ڪيو ويو. Commit and Push تي ڪلڪ ڪريو ... هڪ ڀيرو ٻيهر اسان جائزو وٺون ٿا ۽ چيڪ ڪريون ٿا ته ڇا واقعي اسان مقامي ريپوزٽري کان ريموٽ تائين پُش ڪرڻ چاهيون ٿا ۽ پڪ ڪريو ته سڀ ڪجهه ٺيڪ آهي، پش تي ڪلڪ ڪريو . اسان جو ايندڙ قدم ڇا آهي؟ سڀني ضابطن جي مطابق (جيڪو هن مضمون ۾ پڙهي سگهجي ٿو، GitHub جي وهڪري بابت حصو ۾)، توهان کي مکيه شاخ لاء پل درخواست ٺاهڻ جي ضرورت آهي ۽ ڪوڊ جو جائزو وٺڻ لاء ٽيم مان ڪنهن جو انتظار ڪريو. جيئن ته مان پاڻ تي آهيان، مان رسمي طور تي هڪ پل جي درخواست ٺاهيندس ۽ هر شيء جو ٻيهر جائزو وٺندس. مان وڃان ٿو مخزن واري صفحي تي، ۽ Github اڳ ۾ ئي ڄاڻي ٿو ته اسان وٽ هڪ اضافو آهي ۽ هڪ پل جي درخواست ٺاهڻ لاء پيش ڪري ٿو: محب وطن لاء ڪو به رڪاوٽون نه آهن (c) - اسان ان کي ٺاهيو، جيئن تجويز ڪيل آهي. اسان ساڳيو ليبل، پروجيڪٽ سيٽ ڪيو جنهن ڪم تي اسان ڪم ڪري رهيا آهيون، ۽ تفصيل ڀريو: ڪلڪ ڪريو Create pull request .

سي آء جي عمل کي ترتيب ڏيڻ

اسان ٺاھيل پل جي درخواست ڏانھن وڃون ٿا: ھيٺ اسان ڏسون ٿا ته اسان وٽ مسلسل انٽيگريشن ترتيب نه آھي (هتان کان پوء - CI). خير، اهو ترتيب نه آهي، پوء ڇا؟ اسان کي CI جي ضرورت ڇو آهي؟ تنهن هوندي به CI ڇا آهي؟ هي تقريبن سوالن جي فهرست آهي جيڪا هن وقت اسان کي پريشان ڪرڻ گهرجي. عام طور تي، سي آءِ ڪوڊ کي ضم ڪرڻ جو هڪ مسلسل عمل آهي هڪ عام ڪوڊ بيس ۾ ۽ ان کان اڳ منصوبي جي تعمير کي هلائڻ. نام نهاد تعمير (انگريزي تعمير مان). هر دفعي اسان هڪ پروجيڪٽ ٺاهيندا آهيون، اسان پڪ ڪريون ٿا ته پروجيڪٽ مرتب ڪيو ويو آهي، ان جا سڀئي تجربا ڪاميابيءَ سان گذري چڪا آهن، ان سان گڏ پراجيڪٽ ٺاهڻ کان پوءِ، توهان ٽيسٽرز کان سي آءِ ۾ آٽو ٽيسٽ شامل ڪري سگهو ٿا جيڪي هن مخصوص بلڊ تي هلن ٿا. هن طريقي سان، اسان وڌيڪ اعتماد ٿي چڪا آهيون ته نئين تبديليون ڪم ڪن ٿيون جيئن اسان توقع ڪندا آهيون ۽ اڳئين ڪارڪردگي کي ٽوڙڻ نه ڏيندا آهن. CI پڻ سٺو آهي ڇو ته اهو خودڪار طريقي سان شروع ٿئي ٿو ڪوڊ بيس کي اپڊيٽ ڪرڻ کان پوء. اھو آھي، اسان پنھنجي تبديلين کي شاخ ۾ ڌڪايو ۽ عمل شروع ڪيو - اسيمبلي، ٽيسٽ، آٽو ٽيسٽ ۽ ٻيا مرحلا. جيڪڏهن انهن مان ڪو به مرحلو ناڪام ٿئي ٿو، تعمير کي ڀڃي سمجهيو ويندو آهي ۽ مکيه شاخ ۾ ملائي نٿو سگهجي. اھو اھو آھي جيڪو اسان ھاڻي ڪنداسين: اسان شامل ڪنداسين GitHub عمل، جيڪو اسان جي ڪوڊ کي دٻائڻ کان پوء هلندو. GitHub ڪارناما اسان جي GitHub فلو ۾ مڪمل طور تي ٺهڪي اچي ٿو، تنهنڪري اسان ان کي استعمال ڪنداسين اسان جي ڪم کي خودڪار ڪرڻ لاء. ھي اوزار تمام طاقتور ۽ وڏو آھي، پر ھاڻي اسان ان کي صرف تعمير هلائڻ لاءِ استعمال ڪنداسين ۽ چيڪ ڪنداسين ته اھو ضرورت مطابق گڏ ٿيل آھي. ان کي فعال ڪرڻ لاءِ، ڳولھيو ايڪشن بٽڻ مخزن واري صفحي تي ۽ ان کي فالو ڪريو: ڳولھيو مسلسل انٽيگريشن ورڪ فلو جيڪو اسان جي ضرورت آھي: ڪلڪ ڪريو سيٽ اپ ھي ورڪ فلو. اڳيون، اسان کي انهن جي ٽيمپليٽ استعمال ڪرڻ جي آڇ ڪئي وئي آهي: اسان مڪمل طور تي متفق آهيون، اچو ته هر شيء کي ٿورو واضح ڪريون:

# This workflow will build a Java project with Maven
# For more information see: https://help.github.com/actions/language-and-framework-guides/building-and-testing-java-with-maven

name: Java CI with Maven

on:
  push:
    branches: [ main ]
  pull_request:
    branches: [ main ]

jobs:
  build:

    runs-on: ubuntu-latest

    steps:
    - uses: actions/checkout@v2
    - name: Set up JDK 1.8
      uses: actions/setup-java@v1
      with:
        java-version: 1.8
    - name: Build with Maven
      run: mvn -B package --file pom.xml

اهو ظاهر ڪري ٿو ته GitHub ايڪشن ٻن ڪيسن ۾ سڏيو ويندو آهي:

1. جڏهن هڪ ڌڪ مکيه شاخ ڏانهن ٺاهيو ويندو آهي.
2. جڏهن هڪ پل جي درخواست مکيه شاخ ۾ ٺاهي وئي آهي.

نوڪريون سيڪشن بيان ڪري ٿو قدم جيڪي ڪيا ويندا. اسان وٽ صرف هڪ قدم آهي - تعمير. اهو ڏيکاري ٿو ته اسان جو منصوبو Ubuntu ۾ ڪمانڊ سان شروع ڪيو ويندو mvn -B package --file pom.xml . اهو ئي آهي جيڪو اسان مقامي طور تي ڪيو. جيڪڏهن توهان هتي ڪجهه تبديل ڪرڻ چاهيو ٿا، مهرباني ڪري. مان هي ٽيمپليٽ استعمال ڪندس، اهو منهنجي لاءِ ڪافي هوندو. مان ڪلڪ ڪريو Start commit , چونڊيو نئين برانچ ٺاھيو عمل کي ترتيب ڏيڻ لاءِ ۽ پوءِ تجويز ڪريو نئين فائل . پر تعمير جو عمل گر ٿي ويو ... جيئن توهان ڏسي سگهو ٿا، 14s کان پوء ناڪام ٿيڻ - تعمير. ائين ٿو لڳي ته ڪجهه ٿيو آهي: اچو ته اسيمبلي ڏانهن وڃو ۽ تفصيل ڏسو: اهو چوي ٿو ته مون کي اهڙي يادگيري نه ملي سگهي. ڇو؟ ها، بلڪل، بلڪل! ڇاڪاڻ ته اسان ماسٽر برانچ ۾ تبديليون ڪيون، پر اسان جو ڪم اڃا تائين ناهي. ۽ اهو ئي سبب آهي ته هن کي يادگيري نه ملي... تنهن ڪري، هاڻي اسان هيٺيون ڪندا آهيون: اسان هن ڊيٽا کي ماسٽر ۾ ضم ڪريون ٿا، پوء اسان مکيه شاخ کي JRTB-0 ۾ ضم ڪريون ٿا، ۽ پوء سڀ ڪجهه ٺيڪ ٿيڻ گهرجي. گٿب عملن جي تبديلين سان گڏ پل جي درخواست ۾، ڪلڪ ڪريو ضم ڪرڻ جي درخواست : ۽ ورجائي تصديق ڪريو ضم . اڳيون، Github اسان کي شاخ کي ختم ڪرڻ لاء اشارو ڪري ٿو جنهن ۾ اسان ڪم ڪيو. اسان انڪار نٿا ڪريون ۽ حذف ڪريون ٿا: اڳيون، مون کي اسپرنگ بوٽ جي پل جي درخواست ۾ نه مليو ته ويب سائيٽ مان مکيه شاخ مان تبديلين کي ڪيئن ڇڪايو وڃي، تنهنڪري اسان اهو دستي طور تي IDEA ذريعي ڪنداسين.

قدم 1: ماسٽر برانچ کي مقامي مخزن کي تازه ڪاري ڪريو.

اهو خيال آهي ته ماسٽر برانچ ڏانهن وڃو، ctrl + t کي دٻايو ۽ ماسٽر برانچ کي اپڊيٽ ڪريو:

قدم 2: ماسٽر برانچ کان JRTB-0 برانچ ۾ تبديلين کي ضم ڪريو.

اچو ته وڃو JRTB-0 ۽ ان ۾ مکيه کي ضم ڪريو.

قدم 3: تبديلين کي ڇڪيو.

ctrl + shift + k کي دٻايو ۽ پڪ ڪريو پڪ ڪريو. ھاڻي اسان انتظار ڪري رھيا آھيون تعمير ٿيڻ جو ۽ اھو سائو ٿيندو!)) پر اھو وري ڳاڙھو آھي. اهو ڇا آهي؟ اسان عملن جي لاگن ۾ وڃون ٿا ۽ ڏسون ٿا ته اسان جاوا ورزن ۾ هم وقت سازي کان ٻاهر آهيون. GitHubActions ۾ اهو 8 آهي، پر اسان 11 استعمال ڪندا آهيون: هاڻي ٻه آپشن آهن: يا ته ڪارناما درست ڪريو، يا ورجن کي اٺين تائين گھٽ ڪريو. پهريون اختيار، مون کي لڳي ٿو، بهتر ۽ وڌيڪ صحيح آهي. اسان هڪ الڳ ڪمٽ ۾ تبديليون ڪري رهيا آهيون: اسان ڪم ڪنداسين جاوا 8 سان نه، پر جاوا 11 سان. ۽ ان کان پوء، آخرڪار، اسان لاء سڀ ڪجهه ڪم ڪيو، ۽ اسان منصوبي لاء اسان جي سي آء جي عمل کي قائم ڪرڻ جي قابل ٿي ويا. اهڙين شين کي شروعاتي اسٽيج تي ترتيب ڏيڻ جي ضرورت آهي، انهي ڪري ته توهان کي بعد ۾ ان بابت پريشان ٿيڻ جي ضرورت ناهي. هاڻي توهان ڏسي سگهو ٿا ته تعمير گذري چڪو آهي ۽ توهان بغير بغير ضم ڪري سگهو ٿا:

مخزن ۾ شاخن سان ڪم قائم ڪرڻ

توهان پڻ اهڙيون شيون ترتيب ڏئي سگهو ٿا مخزن ۾ ضابطن جي طور تي جڏهن شاخن سان ڪم ڪري رهيا آهيو. مان ان کي ٺاهڻ چاهيان ٿو ته مکيه شاخ سڌو سنئون نه ٿي سگهي، پر صرف پل جي درخواستن جي ذريعي، ۽ مان اهو ڪرڻ چاهيان ٿو ته پل جي درخواست کي ضم ڪرڻ ناممڪن آهي جيڪڏهن تعمير ناڪام ٿئي ٿي (يعني، جيڪڏهن GitHub تي عمل ناڪام ٿي. ڪجهه قدم). ائين ڪرڻ لاءِ، سيٽنگ جو بٽڻ ڳولھيو ۽ برانچز کي منتخب ڪريو : ھن وقت برانچز لاءِ ڪي به قاعدا نه آھن، تنھنڪري اچو ته Add Rule بٽڻ ذريعي ھڪڙو نئون شامل ڪريون : ھتي ڪيتريون ئي سيٽنگون آھن، ۽ ھر ڪو پنھنجي مرضي مطابق ڪجھ ڪري سگھي ٿو. ضرورتون. ضم ٿيڻ کان اڳ پل جي درخواست ۾ ڪاميابيءَ سان پاس ٿيڻ لاءِ تعمير لاءِ، ضم ٿيڻ کان اڳ پاس ڪرڻ لاءِ اسٽيٽس چيڪ جي ضرورت لاءِ چيڪ بڪس شامل ڪريو ۽ اسٽيٽس کي چونڊيو جيڪو اسان کي گھربل آھي - ٺاھيو. ھاڻي اھو ئي ڪافي آھي: پوءِ توھان ھن اسٽيئرنگ ويل کي اپڊيٽ ڪري سگھوٿا ۽ ڏسو ته توھان کي ٻيو ڇا گھرجي. ڪلڪ ڪريو ٺاھيو ھن اسٽيرنگ ويل کي ٺاھيو. اڳيون، جيڪڏهن اسان ٻيهر اسان جي پل جي درخواست تي وڃون ٿا، اسان ڏسي سگهون ٿا ته اسان جي چيڪ کي هاڻي گهربل نشان لڳايو ويو آهي: اچو ته اسان جي پروجيڪٽ پيج کي چيڪ ڪريو، جيڪو ڏيکاري ٿو سڀني ٽاسڪ اسٽيٽس: توهان فوري طور تي ڏسي سگهو ٿا ته ڪهڙي ڪم تي ڪم ڪيو پيو وڃي. ان کان علاوه، ڪم اڳ ۾ ئي ٿي چڪو آهي، ۽ ڪم ڪوڊ جائزو جي حيثيت ۾ آهي.

بند ڪرڻ JRTB-0

هاڻي ته اسان هڪ پل جي درخواست تيار ڪئي آهي ۽ ان لاءِ هڪ سي آءِ ٺاهيو آهي، اسان کي آخري مرحلي کي مڪمل ڪرڻ جي ضرورت آهي: ڪم کي بند ڪريو، ان کي درست حالت ۾ منتقل ڪريو، بورڊ تي اسان جي پروجيڪٽ ۾ تبديلين کي ڏسو. اسان جي پل جي درخواست تيار آهي ماسٽر ۾ ضم ٿيڻ لاءِ. پل جي درخواست ۾، ضم ڪرڻ جي درخواست واري بٽڻ تي ڪلڪ ڪريو : ڪامياب ضم ٿيڻ کان پوء، توھان ان کي ختم ڪري سگھو ٿا، ۽ عام طور تي ائين ڪريو. مان اهو نه ڪندس ته توهان لاءِ برانچن/ڪميٽ جي وچ ۾ تبديلين کي ڏسڻ آسان بڻائي. جيئن ئي هڪ پل جي درخواست ضم ڪئي وئي آهي، اهو خودڪار طور تي اسان جي پروجيڪٽ بورڊ ۾ ڪيو ويندو آهي: آخري قدم اهو آهي ته مسئلو (مسئلو) کي بند ڪرڻ لاء پل جي درخواست جي لنڪ سان جنهن ۾ اهو هو: اهو مسئلو خودڪار طريقي سان ٿي ويندو آهي. بورڊ. شروعات ڪئي وئي آهي، پهريون ڪم ڪيو ويو آهي!

نتيجا

اهو لڳي ٿو ته اسان اڳ ۾ ئي ڪم ڪرڻ ۽ ڪوڊ لکڻ شروع ڪيو آهي، پر سيٽنگون اڃا تائين گهربل آهن. ها، اهو وقت وٺندو آهي، پر اهو هڪ سئو ڀيرا ادا ڪندو جڏهن پروجيڪٽ وڏو ۽ وڌيڪ پيچيده ٿي ويندو ۽ توهان کي ضمانت جي ضرورت آهي ته توهان صرف هڪ واعدو سان هر شيء کي ٽوڙي نه سگهندا. پل جي درخواست جتي اهو سڀ ٿئي ٿو هتي موجود آهي . شايد، جڏهن توهان پڙهي، اهو اڳ ۾ ئي بند ٿي ويندو. اهو خوفناڪ ناهي: سڀ ضروري معلومات لنڪ ذريعي محفوظ ڪئي ويندي. پڙهڻ لاءِ توهان سڀني جي مهرباني، جلد ملنداسين. وڌيڪ وڌيڪ!

سيريز ۾ سڀني مواد جي هڪ فهرست هن مضمون جي شروعات ۾ آهي.