GitHub क्रियाओं, Node.js, CouchDB और Aptible के साथ ब्लॉग पोस्ट ऐप परिनियोजन को स्वचालित कैसे करें

GitHub Actions, Node.js का उपयोग करके ब्लॉग पोस्ट ऐप परिनियोजन को स्वचालित करने पर मार्गदर्शिका में आपका स्वागत है।

काउचडीबी, और एप्टिबल।

यह व्यापक ट्यूटोरियल आपको उपरोक्त टूल और तकनीकों का उपयोग करके ब्लॉग पोस्ट एप्लिकेशन के निर्माण, तैनाती और प्रबंधन में मार्गदर्शन करेगा।

लेकिन पहले, मैं आपको ब्लॉगपोस्ट ऐप का संक्षिप्त विवरण देता हूं, यह क्या करता है और इसके मुख्य घटक क्या हैं। ब्लॉगपोस्ट ऐप एक वेब एप्लिकेशन है जो उपयोगकर्ताओं को ब्लॉग पोस्ट बनाने और साझा करने की अनुमति देता है।

उपयोगकर्ता अन्य उपयोगकर्ताओं की पोस्ट लिख सकते हैं, संपादित कर सकते हैं, हटा सकते हैं और देख सकते हैं। ऐप बैकएंड के रूप में Node.js, डेटाबेस के रूप में CouchDB और निरंतर एकीकरण और परिनियोजन टूल के रूप में GitHub Actions का उपयोग करता है।

मैंने इन्हें क्यों चुना? वैसे तो कई कारण हैं, लेकिन यहां कुछ मुख्य कारण हैं:

• Node.js एक तेज़, स्केलेबल और उपयोग में आसान जावास्क्रिप्ट रनटाइम वातावरण है जो विभिन्न प्लेटफार्मों पर चल सकता है। इसमें वेब विकास के लिए कई लाइब्रेरी और फ्रेमवर्क हैं, जैसे एक्सप्रेस, एक न्यूनतम और लचीला वेब एप्लिकेशन फ्रेमवर्क जिसका मैं इस प्रोजेक्ट में उपयोग करूंगा।

• CouchDB एक ओपन-सोर्स NoSQL डेटाबेस सिस्टम है जो विश्वसनीय, सुरक्षित और शक्तिशाली है। यह एक दस्तावेज़-उन्मुख डेटाबेस है जो डेटा संग्रहीत करने के लिए JSON का उपयोग करता है।

• GitHub Actions एक लचीला, सुविधाजनक और एकीकृत उपकरण है जो आपको अपने GitHub रिपॉजिटरी के लिए वर्कफ़्लो को स्वचालित करने की अनुमति देता है। इसमें कई पूर्व-निर्मित क्रियाएं भी हैं जिन्हें आप अपनी आवश्यकताओं के लिए उपयोग या अनुकूलित कर सकते हैं, जैसे कि एप्टिबल डिप्लॉय एक्शन, जिसका उपयोग मैं इस प्रोजेक्ट में ऐप को एप्टिबल पर तैनात करने के लिए करूंगा।

• एप्टिबल कंटेनरीकृत अनुप्रयोगों को तैनात करने और प्रबंधित करने, आसान प्रावधान, स्केलिंग और निगरानी क्षमताएं प्रदान करने के लिए एक क्लाउड-आधारित प्लेटफ़ॉर्म है।

आवश्यक शर्तें

विकास यात्रा शुरू करने से पहले, आवश्यक उपकरण और प्रौद्योगिकी स्थापित करना आवश्यक है।

• Node.js: सुनिश्चित करें कि Node.js आपकी मशीन पर स्थापित है।

• CouchDB: सत्यापित करें कि CouchDB आपके सिस्टम पर स्थापित और चल रहा है।

• Node.js और JavaScript विशेषज्ञता: Node.js और JavaScript के बुनियादी सिद्धांतों की ठोस समझ होनी चाहिए।

• डॉकर: अपनी मशीन पर डॉकर इंस्टॉल करें और चलाएं।

• एप्टिबल अकाउंट: एक एप्टिबल अकाउंट बनाएं, और एक बुनियादी एप्लिकेशन को तैनात करने से खुद को परिचित करें।

• डॉकर क्लाउड खाता: अपने एप्लिकेशन होस्ट करने के लिए एक डॉकर क्लाउड खाता प्राप्त करें।

ब्लॉगपोस्ट ऐप विकसित करना

1: अपना Node.js प्रोजेक्ट सेट करें

• अपने ब्लॉग पोस्ट ऐप के लिए एक प्रोजेक्ट निर्देशिका बनाएं।

• NPM का उपयोग करके एक Node.js प्रोजेक्ट प्रारंभ करें:

 npm init -y

• Express.js फ्रेमवर्क स्थापित करें, जो बैकएंड के लिए आधार के रूप में काम करेगा:

 npm install express nano

चरण 2: CouchDB सेट करें

• सुनिश्चित करें कि CouchDB स्थापित है और चल रहा है। आप http://127.0.0.1:5984/_utils/ पर अपने ब्राउज़र के माध्यम से CouchDB तक पहुंच सकते हैं।

चरण 3: अपना Node.js एप्लिकेशन बनाएं

• अपनी प्रोजेक्ट निर्देशिका में एक blog.js फ़ाइल बनाएँ।

• एक्सप्रेस आरंभ करें, और इसे CouchDB से कनेक्ट करें:

 const express = require("express"); const nano = require("nano")("http://admin:[email protected]:5984"); const app = express(); const port = 3000; // Middleware to parse JSON data app.use(express.json()); // async function asyncCall() { // // await nano.db.destroy("alice"); // await nano.db.create("blogposts"); // const db = nano.use("blogposts"); // return response; // } // asyncCall(); const db = nano.use("blogposts");

• यह कोड CouchDB डेटाबेस का उपयोग करके ब्लॉग पोस्ट बनाने, पुनर्प्राप्त करने, अपडेट करने और हटाने के लिए एपीआई एंडपॉइंट को परिभाषित करता है।

  
  

 // Create a new blog post app.post("/posts", async (req, res) => { const { title, description, author } = req.body; try { const doc = await db.insert({ title, description, author, createdAt: new Date(), updatedAt: new Date(), }); res.json({ id: doc.id, rev: doc.rev }); } catch (err) { console.error(err); res.status(500).send("Error creating post"); } }); // Get all blog posts app.get("/posts", async (req, res) => { try { const docs = await db.list({ include_docs: true }); res.json(docs.rows); } catch (err) { console.error(err); res.status(500).send("Error retrieving posts"); } }); // Get a specific blog post app.get("/posts/:id", async (req, res) => { const { id } = req.params; try { const doc = await db.get(id); res.json(doc); } catch (err) { console.error(err); res.status(404).send("Post not found"); } }); // Update a blog post app.put("/posts/:id", async (req, res) => { const { id } = req.params; const { title, description } = req.body; try { await db.insert({ _id: id, title, description, updatedAt: new Date(), }); res.json({ message: "Post updated successfully" }); } catch (err) { console.error(err); res.status(500).send("Error updating post"); } }); // Delete a blog post app.delete("/posts/:id", async (req, res) => { const { id } = req.params; try { await db.destroy(id); res.json({ message: "Post deleted successfully" }); } catch (err) { console.error(err); res.status(500).send("Error deleting post"); } }); app.listen(port, () => { console.log(`Blogpost app listening on port ${port}`); });

इसका स्थानीय स्तर पर परीक्षण करना:

आपके प्रोजेक्ट की कार्यक्षमता और मजबूती सुनिश्चित करने के लिए संपूर्ण परीक्षण महत्वपूर्ण है। आपकी परीक्षण प्रक्रिया का मार्गदर्शन करने के लिए यहां एक नमूना एपीआई दस्तावेज़ दिया गया है:

एपीआई दस्तावेज़ीकरण

आधार यूआरएल :

यह मानते हुए कि आपका सर्वर स्थानीय रूप से पोर्ट 3000 पर चल रहा है, आपके एपीआई का आधार यूआरएल होगा:

 http://localhost:3000

एपीआई समापन बिंदु:

एक नया ब्लॉग पोस्ट बनाएं

• समापन बिंदु : POST /posts

• विवरण : एक नया ब्लॉग पोस्ट बनाता है।

• अनुरोध निकाय :

   { "title": "String", "description": "String", "author": "String" }

• उदाहरण :

   POST http://localhost:3000/posts { "title": "Sample Title", "description": "Sample Description", "author": "John Doe" }

सभी ब्लॉग पोस्ट प्राप्त करें

• समापन बिंदु : GET /posts

• विवरण : सभी ब्लॉग पोस्ट पुनर्प्राप्त करता है।

• प्रतिक्रिया :

   [ { "id": "String", "key": "String", "value": { "rev": "String" }, "doc": { "_id": "String", "_rev": "String", "title": "String", "description": "String", "author": "String", "createdAt": "Date", "updatedAt": "Date" } } ]

• उदाहरण :

   GET http://localhost:3000/posts

एक विशिष्ट ब्लॉग पोस्ट प्राप्त करें

• समापन बिंदु : GET /posts/:id

• विवरण : किसी विशिष्ट ब्लॉग पोस्ट को उसकी आईडी के आधार पर पुनः प्राप्त करता है।

• पैरामीटर्स :

  • id : ब्लॉग पोस्ट की आईडी.

• प्रतिक्रिया :

   { "_id": "String", "_rev": "String", "title": "String", "description": "String", "author": "String", "createdAt": "Date", "updatedAt": "Date" }

• उदाहरण :

   GET http://localhost:3000/posts/your-post-id

ब्लॉग पोस्ट अपडेट करें

• समापन बिंदु : PUT /posts/:id

• विवरण : किसी विशिष्ट ब्लॉग पोस्ट को उसकी आईडी के आधार पर अपडेट करता है।

• पैरामीटर्स :

  • id : ब्लॉग पोस्ट की आईडी.

• अनुरोध निकाय :

   { "title": "String", "description": "String" }

• उदाहरण :

   PUT http://localhost:3000/posts/your-post-id { "title": "Updated Title", "description": "Updated Description" }

ब्लॉग पोस्ट हटाएँ

• समापन बिंदु : DELETE /posts/:id

• विवरण : किसी विशिष्ट ब्लॉग पोस्ट को उसकी आईडी के आधार पर हटाता है।

• पैरामीटर्स :

  • id : ब्लॉग पोस्ट की आईडी.

• उदाहरण :

   DELETE http://localhost:3000/posts/your-post-id

GET , PUT और DELETE अनुरोधों का परीक्षण करते समय कृपया your-post-id ब्लॉग पोस्ट की वास्तविक आईडी से बदलें।

चरण 4: अपने Node.js एप्लिकेशन को डॉकराइज़ करें

आपके पास एक डॉकर हब खाता होना चाहिए। यदि आपने अभी तक कोई नहीं बनाया है, तो डॉकर हब पर साइन अप करें।

डॉकरीकृत ऐप को डॉकर हब में पुश करने के चरण:

• अपने Node.js प्रोजेक्ट की रूट डायरेक्टरी में एक Dockerfile बनाएं ।

 # Use an official Node.js runtime as the base image FROM node:16 # Set the working directory in the container WORKDIR /usr/src/app # Copy package.json and package-lock.json to the working directory COPY package*.json ./ # Install app dependencies RUN npm install # Copy the rest of the application files to the working directory COPY . . # Expose the port the app runs on EXPOSE 3000 # Define the command to run the app CMD ["node", "blog.js"]

• अपनी डॉकर छवि को टैग करें: अपना टर्मिनल/कमांड प्रॉम्प्ट खोलें और अपने Node.js एप्लिकेशन की रूट निर्देशिका पर नेविगेट करें, जहां आपकी डॉकर फ़ाइल स्थित है।

  
  

अपनी डॉकर छवि बनाने के लिए निम्नलिखित कमांड चलाएँ, और इसे अपने डॉकर हब उपयोगकर्ता नाम और वांछित रिपॉजिटरी नाम के साथ टैग करें:

 docker build -t your-docker-username/blogpost-app:latest .

your-docker-username अपने डॉकर हब उपयोगकर्ता नाम से और blogpost-app अपने इच्छित रिपॉजिटरी नाम से बदलें।

आपको इसी तरह की प्रतिक्रिया मिलेगी:

 [+] Building 1.1s (10/10) FINISHED docker:desktop-linux => [internal] load .dockerignore 0.0s => => transferring context: 2B 0.0s => [internal] load build definition from Dockerfile 0.0s => => transferring dockerfile: 489B 0.0s => [internal] load metadata for docker.io/library/node:16 1.0s => [1/5] FROM docker.io/library/node:16@sha256:f77a1aef2da8d83e45ec990f45df50f1a286c5fe8bbfb8c6e4246c6389705c0b 0.0s => [internal] load build context 0.0s => => transferring context: 45.31kB 0.0s => CACHED [2/5] WORKDIR /usr/src/app 0.0s => CACHED [3/5] COPY package*.json ./ 0.0s => CACHED [4/5] RUN npm install 0.0s => CACHED [5/5] COPY . . 0.0s => exporting to image 0.0s => => exporting layers 0.0s => => writing image sha256:c5f046a9b99389aea6bf3f503e9b05cce953daf1b3f77ee5fb3f7469dc36c709 0.0s => => naming to docker.io/wise4rmgod/blogpost-app:latest

• डॉकर हब में लॉग इन करें: निम्नलिखित कमांड निष्पादित करके अपने डॉकर हब खाते से अपने डॉकर क्लाइंट को प्रमाणित करें:

 docker login

संकेत मिलने पर अपना डॉकर हब उपयोगकर्ता नाम और पासवर्ड दर्ज करें।

 Authenticating with existing credentials... Login Succeeded

• डॉकर छवि को डॉकर हब पर पुश करें: एक बार लॉग इन करने के बाद, निम्नलिखित कमांड का उपयोग करके अपनी टैग की गई डॉकर छवि को अपने डॉकर हब रिपॉजिटरी पर पुश करें:

 docker push your-docker-username/blogpost-app:latest

यह कमांड आपकी स्थानीय छवि को आपके निर्दिष्ट रिपॉजिटरी के तहत डॉकर हब पर अपलोड करता है।

• पुश को सत्यापित करें: वेब पर अपने डॉकर हब खाते पर जाएं, और यह पुष्टि करने के लिए अपने रिपॉजिटरी पर नेविगेट करें कि आपकी डॉकर छवि को सफलतापूर्वक पुश किया गया है।

  

  
  

 aptible deploy --app reactgame --docker-image wise4rmgod/blogpost-app --private-registry-username wise4rmgod --private-registry-password H$(_tS+W~ZBST63

चरण 5: उपयुक्त तैनाती

• निम्नलिखित कमांड का उपयोग करके सीएलआई के माध्यम से एप्टिबल में लॉग इन करें:

 aptible login

आपको अपना ईमेल और पासवर्ड दर्ज करने के लिए कहा जाएगा। सफल होने पर, आपको इस तरह की प्रतिक्रिया प्राप्त होगी:

 Token written to /Users/wisdomnwokocha/.aptible/tokens.json This token will expire after 6 days, 23 hrs (use --lifetime to customize)

• अब, निम्नलिखित कमांड का उपयोग करके अपना ऐप तैनात करें:

वाक्य - विन्यास:

 aptible deploy --app <app name> --docker-image <docker image in cloud>

यहाँ एक उदाहरण आदेश है:

 aptible deploy --app reactgame --docker-image wise4rmgod/blogpost-app

आपको निम्नलिखित के समान प्रतिक्रिया प्राप्त होगी:

 INFO -- : Starting App deploy operation with ID: 61135861 INFO -- : Deploying without git repository INFO -- : Writing .aptible.env file... INFO -- : Fetching app image: wise4rmgod/blogpost-app... INFO -- : Pulling from wise4rmgod/blogpost-app INFO -- : 26ee4ff96582: Pulling fs layer INFO -- : 446eab4103f4: Pulling fs layer INFO -- : 2e3c22a0f840: Pulling fs layer INFO -- : a7ab8ad9b408: Pulling fs layer INFO -- : 3808fdf0c601: Pulling fs layer INFO -- : ab9e4075c671: Pulling fs layer INFO -- : 362360c8cef6: Pulling fs layer INFO -- : 928b5d11ac66: Pulling fs layer INFO -- : dc87e077ac61: Pulling fs layer INFO -- : f108e80f4efc: Pulling fs layer INFO -- : 84ac53840ac8: Pulling fs layer INFO -- : e81f21b79a1f: Pulling fs layer INFO -- : 2e3c22a0f840: Downloading: 523 KB / 49.8 MB INFO -- : 446eab4103f4: Downloading: 173 KB / 16.6 MB INFO -- : 26ee4ff96582: Downloading: 483 KB / 47 MB INFO -- : 2e3c22a0f840: Downloading: 25.7 MB / 49.8 MB INFO -- : a7ab8ad9b408: Downloading: 528 KB / 175 MB INFO -- : ab9e4075c671: Downloading: 355 KB / 33.4 MB INFO -- : a7ab8ad9b408: Downloading: 35.3 MB / 175 MB INFO -- : 26ee4ff96582: Pull complete INFO -- : 446eab4103f4: Pull complete INFO -- : 2e3c22a0f840: Pull complete INFO -- : a7ab8ad9b408: Downloading: 71.2 MB / 175 MB INFO -- : a7ab8ad9b408: Downloading: 106 MB / 175 MB INFO -- : a7ab8ad9b408: Downloading: 142 MB / 175 MB INFO -- : a7ab8ad9b408: Pull complete INFO -- : 3808fdf0c601: Pull complete INFO -- : ab9e4075c671: Pull complete INFO -- : 362360c8cef6: Pull complete INFO -- : 928b5d11ac66: Pull complete INFO -- : dc87e077ac61: Pull complete INFO -- : f108e80f4efc: Pull complete INFO -- : 84ac53840ac8: Pull complete INFO -- : e81f21b79a1f: Pull complete INFO -- : Digest: sha256:de9d04d069ca89ebdb37327365a815c88cd40d90cbc5395cc31c351fff1206dd INFO -- : Status: Downloaded newer image for wise4rmgod/blogpost-app:latest INFO -- : No Procfile found in git directory or /.aptible/Procfile found in Docker image: using Docker image CMD INFO -- : No .aptible.yml found in git directory or /.aptible/.aptible.yml found in Docker image: no before_release commands will run INFO -- : Pushing image dualstack-v2-registry-i-0a5ec8cff8e775b34.aptible.in:46022/app-63213/72184c41-7dc6-4313-b10e-749125f72577:latest to private Docker registry... INFO -- : The push refers to repository [dualstack-v2-registry-i-0a5ec8cff8e775b34.aptible.in:46022/app-63213/72184c41-7dc6-4313-b10e-749125f72577] INFO -- : dd387bc6b362: Pushed INFO -- : 586bd9d5efcf: Pushed INFO -- : 8ae0c889ca84: Pushed INFO -- : c91ec53bcc27: Pushing: 522 KB / 93.6 MB INFO -- : aec897bac4f0: Pushed INFO -- : 0ead224631d3: Pushed INFO -- : ad3b30eb29d3: Pushing: 542 KB / 444 MB INFO -- : 2a7587eb01b6: Pushing: 544 KB / 137 MB INFO -- : be36d2a441aa: Pushed INFO -- : 03f6e3800bbe: Pushed INFO -- : a10e482288d1: Pushing: 338 KB / 30.7 MB INFO -- : f9cfc9f6b603: Pushing: 513 KB / 103 MB INFO -- : c91ec53bcc27: Pushing: 31.3 MB / 93.6 MB INFO -- : c91ec53bcc27: Pushing: 62.7 MB / 93.6 MB INFO -- : ad3b30eb29d3: Pushing: 44.5 MB / 444 MB INFO -- : 2a7587eb01b6: Pushing: 34.4 MB / 137 MB INFO -- : a10e482288d1: Pushed INFO -- : ad3b30eb29d3: Pushing: 88.9 MB / 444 MB INFO -- : f9cfc9f6b603: Pushing: 34.6 MB / 103 MB INFO -- : 2a7587eb01b6: Pushing: 68.9 MB / 137 MB INFO -- : ad3b30eb29d3: Pushing: 133 MB / 444 MB INFO -- : f9cfc9f6b603: Pushing: 70.2 MB / 103 MB INFO -- : c91ec53bcc27: Pushed INFO -- : 2a7587eb01b6: Pushing: 103 MB / 137 MB INFO -- : ad3b30eb29d3: Pushing: 178 MB / 444 MB INFO -- : ad3b30eb29d3: Pushing: 224 MB / 444 MB INFO -- : 2a7587eb01b6: Pushed INFO -- : f9cfc9f6b603: Pushed INFO -- : ad3b30eb29d3: Pushing: 270 MB / 444 MB INFO -- : ad3b30eb29d3: Pushing: 312 MB / 444 MB INFO -- : ad3b30eb29d3: Pushing: 355 MB / 444 MB INFO -- : ad3b30eb29d3: Pushing: 401 MB / 444 MB INFO -- : ad3b30eb29d3: Pushed INFO -- : latest: digest: sha256:de9d04d069ca89ebdb37327365a815c88cd40d90cbc5395cc31c351fff1206dd size: 2841 INFO -- : Pulling from app-63213/72184c41-7dc6-4313-b10e-749125f72577 INFO -- : Digest: sha256:de9d04d069ca89ebdb37327365a815c88cd40d90cbc5395cc31c351fff1206dd INFO -- : Status: Image is up to date for dualstack-v2-registry-i-0a5ec8cff8e775b34.aptible.in:46022/app-63213/72184c41-7dc6-4313-b10e-749125f72577:latest INFO -- : Image app-63213/72184c41-7dc6-4313-b10e-749125f72577 successfully pushed to registry. INFO -- : STARTING: Register service cmd in API INFO -- : COMPLETED (after 0.28s): Register service cmd in API INFO -- : STARTING: Derive placement policy for service cmd INFO -- : COMPLETED (after 0.15s): Derive placement policy for service cmd INFO -- : STARTING: Create new release for service cmd INFO -- : COMPLETED (after 0.24s): Create new release for service cmd INFO -- : STARTING: Schedule service cmd .. INFO -- : COMPLETED (after 13.49s): Schedule service cmd INFO -- : STARTING: Stop old app containers for service cmd INFO -- : COMPLETED (after 0.0s): Stop old app containers for service cmd INFO -- : STARTING: Start app containers for service cmd INFO -- : WAITING FOR: Start app containers for service cmd INFO -- : WAITING FOR: Start app containers for service cmd INFO -- : COMPLETED (after 18.4s): Start app containers for service cmd INFO -- : STARTING: Delete old containers for service cmd in API INFO -- : COMPLETED (after 0.0s): Delete old containers for service cmd in API INFO -- : STARTING: Commit app containers in API for service cmd INFO -- : COMPLETED (after 0.26s): Commit app containers in API for service cmd INFO -- : STARTING: Commit service cmd in API INFO -- : COMPLETED (after 0.13s): Commit service cmd in API INFO -- : STARTING: Cache maintenance page INFO -- : COMPLETED (after 0.28s): Cache maintenance page INFO -- : STARTING: Commit app in API INFO -- : COMPLETED (after 0.19s): Commit app in API INFO -- : App deploy successful.

• यह पुष्टि करने के लिए कि परिनियोजन सफल रहा, एप्टिबल डैशबोर्ड पर जाएँ।

• डैशबोर्ड में एंडपॉइंट टैब पर क्लिक करें और एंडपॉइंट को सेव करें। यह आपको अपने डेटाबेस को सार्वजनिक इंटरनेट पर प्रदर्शित करने की अनुमति देगा।

• नया एंडपॉइंट बनाने के लिए अगली स्क्रीन में ऐड एंडपॉइंट पर क्लिक करें।

निष्कर्ष

यह व्यापक ट्यूटोरियल आपको Node.js, CouchDB और Aptible के साथ ब्लॉग पोस्ट एप्लिकेशन बनाने, तैनात करने और प्रबंधित करने में मदद करेगा।

आपने आवश्यक उपकरण और प्रौद्योगिकियों को स्थापित करने, ब्लॉग पोस्ट एप्लिकेशन के बैकएंड को तैयार करने, एप्लिकेशन को डॉकराइज़ करने, डॉकर छवि को डॉकर हब में धकेलने और एप्लिकेशन को एप्टिबल पर तैनात करने की बुनियादी बातों को समझ लिया है।

इस व्यापक ट्यूटोरियल को पूरा करने और एप्टिबल का उपयोग करके क्लाउड-नेटिव एप्लिकेशन डेवलपमेंट में आपकी यात्रा के लिए बधाई!