diff --git a/absolute-beginners/backend-beginner/repo-hosting-services/_category_.json b/absolute-beginners/backend-beginner/repo-hosting-services/_category_.json new file mode 100644 index 0000000..704a670 --- /dev/null +++ b/absolute-beginners/backend-beginner/repo-hosting-services/_category_.json @@ -0,0 +1,8 @@ +{ + "label": "Repo Hosting Services", + "position": 5, + "link": { + "type": "generated-index", + "description": "Where does your code live? Explore the major cloud platforms used to host, share, and collaborate on Git repositories, from GitHub to GitLab." + } +} \ No newline at end of file diff --git a/absolute-beginners/backend-beginner/repo-hosting-services/bitbucket.mdx b/absolute-beginners/backend-beginner/repo-hosting-services/bitbucket.mdx new file mode 100644 index 0000000..8c2f17a --- /dev/null +++ b/absolute-beginners/backend-beginner/repo-hosting-services/bitbucket.mdx @@ -0,0 +1,82 @@ +--- +sidebar_position: 4 +title: "Bitbucket - The Corporate Choice" +sidebar_label: "4. Bitbucket" +description: "Learn about Bitbucket, the hosting service built for professional teams using the Atlassian suite." +--- + +**Bitbucket** is a Git-based source code repository hosting service owned by **Atlassian**. Its superpower isn't just hosting code; it’s how perfectly it connects with the tools professional project managers use to track work. + +## Why Professional Teams Use Bitbucket + +1. **Deep Jira Integration:** If a manager creates a "Bug" ticket in Jira, a developer can create a "Fix" branch in Bitbucket that is automatically linked to that ticket. +2. **Trello Integration:** You can see the status of your code commits directly on your Trello cards. +3. **Superior Code Review:** Bitbucket’s interface for reviewing code (Pull Requests) is designed to handle very large teams with complex approval rules. +4. **IP Whitelisting:** For high-security companies, Bitbucket allows you to restrict code access so it can only be viewed from specific office IP addresses. + +## Key Bitbucket Features + + + + + * **Jira Links:** See build status and pull requests directly inside Jira tickets. + * **Confluence:** Embed your code documentation and READMEs into your company's internal wiki automatically. + + + + + * **Bitbucket Pipelines:** An integrated CI/CD service built right into the UI. It uses a `bitbucket-pipelines.yml` file to automate your builds and deployments. + * **Zero-Downtime Deploys:** Easily push code to AWS, Azure, or Google Cloud without your website ever going offline. + + + + + * **Git Guard:** Scans your commits to ensure you don't accidentally push sensitive data like API keys. + * **Deployment Permissions:** Control exactly who is allowed to push code to the "Production" server. + + + + +## The Agile Workflow + +In Bitbucket, the workflow is often driven by **Agile Sprints**. + +```mermaid +sequenceDiagram + participant J as Jira (Task) + participant B as Bitbucket (Code) + participant P as Pipeline (Test) + + J->>B: Create Branch from Ticket + B->>B: Developer writes code + B->>P: Trigger Test Pipeline + P-->>B: Tests Passed + B->>J: Update Ticket Status to "Done" + +``` + +## Bitbucket vs. The Others + +| Feature | Bitbucket | GitHub | GitLab | +| --- | --- | --- | --- | +| **Parent Company** | Atlassian | Microsoft | Independent | +| **Best Integration** | Jira / Trello | VS Code / Azure | Kubernetes / Linux | +| **Focus** | Project Management | Community/Social | DevOps Lifecycle | +| **Private Repos** | Free for up to 5 users | Free for everyone | Free for everyone | + +## Recommended Resources + +* **[Bitbucket Tutorials](https://www.atlassian.com/git/tutorials)**: Some of the best Git tutorials on the internet are actually written by the Bitbucket team. +* **[Bitbucket Cloud Docs](https://support.atlassian.com/bitbucket-cloud/)**: Official guide for setting up your first workspace. +* **[Jira & Bitbucket Guide](https://www.atlassian.com/software/jira/bitbucket-integration)**: Learn how to connect your code to your tasks. + +## Summary Checklist + +* [x] I understand that Bitbucket is owned by Atlassian. +* [x] I know that Bitbucket is the best choice for teams using Jira. +* [x] I understand that "Pipelines" is Bitbucket's automation tool. +* [x] I recognize that Bitbucket focuses on private, professional team security. + +:::tip Fun Fact +Unlike GitHub, which only supported Git from the start, Bitbucket used to be a major host for **Mercurial** repositories! They eventually switched to focus exclusively on Git to match the industry standard. +::: \ No newline at end of file diff --git a/absolute-beginners/backend-beginner/repo-hosting-services/choosing-a-host.mdx b/absolute-beginners/backend-beginner/repo-hosting-services/choosing-a-host.mdx new file mode 100644 index 0000000..5937a41 --- /dev/null +++ b/absolute-beginners/backend-beginner/repo-hosting-services/choosing-a-host.mdx @@ -0,0 +1,76 @@ +--- +sidebar_position: 5 +title: "🤔 Choosing the Right Host" +sidebar_label: "5. How to Choose" +description: "A final comparison to help you decide which repository hosting service fits your project and career goals." +--- + +You’ve explored the "Big Three" of the hosting world: **GitHub**, **GitLab**, and **Bitbucket**. While they all speak the language of Git, they are built for different types of developers and workflows. + +This guide will help you make the right choice for your next **CodeHarborHub** project. + +## The "Quick-Start" Decision Tree + +If you are in a hurry, follow this logic: + +```mermaid +graph TD + Start[Start Here] --> A{What is your goal?} + A -- "Build a Portfolio" --> GitHub[GitHub] + A -- "Learn DevOps/Automation" --> GitLab[GitLab] + A -- "Professional Teamwork" --> B{Using Jira/Trello?} + B -- Yes --> Bitbucket[Bitbucket] + B -- No --> GitHub + +``` + +## Feature-by-Feature Comparison + +| Feature | 🐙 GitHub | 🦊 GitLab | 🟦 Bitbucket | +| --- | --- | --- | --- | +| **Best For** | Open Source & Portfolios | Private DevOps & Security | Agile Teams & Jira Users | +| **CI/CD Tool** | GitHub Actions | GitLab CI (Native) | Bitbucket Pipelines | +| **Project Tracking** | Issues & Projects (Simple) | Epics & Milestones (Deep) | Deep Jira Integration | +| **Community** | 100M+ Developers | Medium / Enterprise | Corporate / Professional | +| **Self-Hosting** | Hard / Expensive | Easy / Core Feature | Available for Data Centers | + +## The "CodeHarborHub" Recommendations + +### 1. The Student & Job Seeker Path + +**Winner: GitHub** If you are a student (like a B.Tech graduate) looking for an internship or your first job, **GitHub is non-negotiable**. Recruiters check your GitHub profile to see your "Green Squares" (consistency) and the quality of your code. + +* **Your Move:** Start here to build your public presence. + +### 2. The Private Startup Path + +**Winner: GitLab** If you are building a secret project with a small team and want the most powerful automation tools for free, GitLab is incredible. Its built-in security scanning helps you catch bugs before you even launch. + +* **Your Move:** Choose this if you want to master "DevOps" early. + +### 3. The Corporate / Freelance Path + +**Winner: Bitbucket** If you are working with a client who uses Jira to manage their business, Bitbucket is the most efficient choice. It bridges the gap between the manager’s "To-Do" list and your "Code." + +* **Your Move:** Choose this for professional, organized team projects. + +## Can I use more than one? + +**Yes!** Many developers have: + +* A **GitHub** account for their public open-source contributions. +* A **GitLab** account for their private "side-hustle" experiments. +* A **Bitbucket** account provided by their employer. + +Because they all use **Git**, your commands (`git add`, `git commit`, `git push`) stay exactly the same. You just change the "Remote URL"! + +## Final Summary Checklist + +* [x] I know that GitHub is the best for my public resume. +* [x] I understand that GitLab offers an all-in-one DevOps experience. +* [x] I recognize that Bitbucket is the king of project management integration. +* [x] I am ready to pick a host and push my first project. + +:::success Recommendation for Beginners +At **CodeHarborHub**, we recommend starting with **GitHub**. It has the most tutorials, the most users, and it’s where our community projects live. +::: \ No newline at end of file diff --git a/absolute-beginners/backend-beginner/repo-hosting-services/github.mdx b/absolute-beginners/backend-beginner/repo-hosting-services/github.mdx new file mode 100644 index 0000000..1ae2ba3 --- /dev/null +++ b/absolute-beginners/backend-beginner/repo-hosting-services/github.mdx @@ -0,0 +1,79 @@ +--- +sidebar_position: 2 +title: "GitHub - The Open Source King" +sidebar_label: "2. GitHub" +description: "Learn why GitHub is the world's most popular hosting platform and how to use its social and technical features." +--- + +**GitHub** is the largest and most influential code-hosting platform in the world. Since its acquisition by Microsoft in 2018, it has evolved from a simple repository host into a complete developer ecosystem. If you are building a career in tech, your GitHub profile is your **professional identity**. + +## Why GitHub is the Standard + +GitHub is more than just a place for Git; it is a **Social Network for Code**. + +1. **Open Source Culture:** Almost every major library (React, Node.js, TensorFlow) is hosted here. You can read their code, report bugs, and even contribute. +2. **Pull Requests (PRs):** This is GitHub's "Killer Feature." It allows you to propose changes to a project. The maintainer can review your code, comment on specific lines, and then "merge" it into the project. +3. **The "Green Square" Grid:** Your profile shows a contribution graph. This visual representation of your activity is often checked by recruiters as a sign of consistency. + +## Key GitHub Features + + + + + * **Issues:** A built-in task tracker to report bugs or suggest new features. + * **Discussions:** A forum-style space for community chat. + * **Projects:** Kanban-style boards (like Trello) to manage your development workflow. + + + + + * **GitHub Actions:** Automate your software workflows. You can set it up to run tests every time you "push" code. + * **Dependabot:** Automatically checks your project for outdated or insecure libraries and creates a PR to fix them. + + + + + * **GitHub Pages:** Turn any repository into a live website for free (great for your portfolio!). + * **GitHub Gists:** A simple way to share small snippets of code or notes. + + + + +## The Professional Workflow: Forking & Pull Requests + +In a professional environment, you don't usually push code directly to the "Main" branch. Instead, you use the **Fork and PR** workflow. + + + +```mermaid +sequenceDiagram + participant OS as Original Repo (CodeHarborHub) + participant MyR as Your Fork (Copy) + participant Local as Your Computer + + OS->>MyR: Fork (Create your own copy on GitHub) + MyR->>Local: Clone (Download to your PC) + Local->>Local: Write Code & Commit + Local->>MyR: Push (Upload to your copy) + MyR->>OS: Pull Request (Request to merge your changes) + +``` + +## Essential GitHub Terms + +* **Repository (Repo):** Your project folder stored on GitHub. +* **Star:** Like a "Like" button; it helps you bookmark projects you find useful. +* **Fork:** Creating a personal copy of someone else's repository. +* **Watch:** Notifying you every time there is a new update or discussion in a repo. +* **README.md:** The "Face" of your project. It's the first thing people see and should explain what your project does. + +## Summary Checklist + +* [x] I understand that GitHub is the cloud host for Git repositories. +* [x] I know that my GitHub profile acts as a public resume. +* [x] I understand what a **Pull Request** is used for. +* [x] I recognize that **GitHub Actions** can automate my testing. + +:::success Pro-Tip +At **CodeHarborHub**, we encourage you to customize your **Profile README**. Create a repository with the exact same name as your username (e.g., `github.com/yourname/yourname`) and add a README. It will appear on your main profile page as a beautiful bio! +::: \ No newline at end of file diff --git a/absolute-beginners/backend-beginner/repo-hosting-services/gitlab.mdx b/absolute-beginners/backend-beginner/repo-hosting-services/gitlab.mdx new file mode 100644 index 0000000..32ccbf7 --- /dev/null +++ b/absolute-beginners/backend-beginner/repo-hosting-services/gitlab.mdx @@ -0,0 +1,81 @@ +--- +sidebar_position: 3 +title: "GitLab - The DevOps Specialist" +sidebar_label: "3. GitLab" +description: "Explore GitLab, the all-in-one DevOps platform for hosting, testing, and securing your code." +--- + +**GitLab** is a complete, web-based DevOps platform that provides everything you need to manage a project from start to finish. While GitHub is famous for "Open Source," GitLab is famous for its **"All-in-One"** philosophy—handling planning, coding, security, and deployment in a single app. + +## Why Professionals Choose GitLab + +1. **Powerful Built-in CI/CD:** GitLab was the first to build "Continuous Integration" directly into the platform. You don't need a third-party tool; the automation engine is already there. +2. **Self-Hosting:** Many companies (like NASA and Sony) use GitLab because they can install it on their **own private servers**. This ensures their code never leaves their internal network. +3. **Security First:** GitLab automatically scans your code for security vulnerabilities, secret leaks, and even license compliance as soon as you push your code. +4. **Free Private Repositories:** GitLab was one of the first platforms to offer unlimited private repositories for free, making it a favorite for private startups. + +## The GitLab Architecture: "The DevOps Loop" + +GitLab covers every stage of the software development lifecycle. In the industry, we call this the **DevOps Lifecycle**. + +```mermaid +graph LR + Plan --> Create + Create --> Verify + Verify --> Package + Package --> Release + Release --> Configure + Configure --> Monitor + Monitor --> Plan + +``` + +## Key GitLab Features + + + + +* **GitLab CI/CD:** Uses a simple file called `.gitlab-ci.yml` to run tests and deploy code automatically. +* **Auto DevOps:** Automatically detects the language you are using and sets up a best-practice pipeline for you. + + + + +* **Milestones:** Track groups of issues related to a specific release date. +* **Epics:** High-level goals that contain multiple issues (great for long-term planning). +* **Time Tracking:** Built-in tools to estimate and track how much time developers spend on tasks. + + + + +* **SAST (Static Analysis):** Checks your source code for common security flaws. +* **Dependency Scanning:** Alerts you if any of your `npm` or `pip` packages have known bugs. + + + + +## GitLab vs. GitHub + +| Feature | GitLab | GitHub | +| --- | --- | --- | +| **Philosophy** | All-in-one integrated tool. | Modular (integrates with other apps). | +| **CI/CD** | Deeply integrated and native. | GitHub Actions (Powerful but separate). | +| **Self-Hosting** | Primary feature (GitLab CE/EE). | Available but very expensive (Enterprise). | +| **Community** | Professional & Enterprise. | Largest Open Source community. | + +## Recommended Resources + +* **[GitLab Docs](https://docs.gitlab.com/)**: Extremely detailed documentation for every feature. +* **[GitLab University](https://about.gitlab.com/learn/)**: Video tutorials and paths to become a certified GitLab Associate. +* **[GitLab for Students](https://about.gitlab.com/solutions/education/)**: Check if your university qualifies for a free GitLab Ultimate license! + +## Summary Checklist + +* [x] I understand that GitLab is an "All-in-One" DevOps platform. +* [x] I know that GitLab is famous for its built-in CI/CD pipelines. +* [x] I understand that companies use GitLab because it can be self-hosted. +* [x] I recognize the "DevOps Loop" stages. + +:::tip Pro-Tip +If you ever want to run your own code-hosting server at home on a **Raspberry Pi**, GitLab is the perfect software to install. It gives you full control over your code without relying on any company! +::: \ No newline at end of file diff --git a/absolute-beginners/backend-beginner/repo-hosting-services/intro-to-hosting.mdx b/absolute-beginners/backend-beginner/repo-hosting-services/intro-to-hosting.mdx new file mode 100644 index 0000000..13c4afb --- /dev/null +++ b/absolute-beginners/backend-beginner/repo-hosting-services/intro-to-hosting.mdx @@ -0,0 +1,63 @@ +--- +sidebar_position: 1 +title: "Why Host Your Code?" +sidebar_label: "1. Intro to Hosting" +description: "Understand the importance of Repository Hosting services and how they transform solo coding into professional engineering." +--- + +Up until now, you’ve learned how to use **Git** to track changes on your local machine. But what happens if your laptop spills coffee, or if you want to work with a developer across the world? + +This is where **Repository Hosting Services** come in. + +## What is a Hosting Service? + +A Repository Hosting service is a cloud-based platform that acts as a "Remote Server" for your Git or SVN repositories. It provides a central place where your code lives, accessible from anywhere with an internet connection. + +Think of it this way: +* **Git** is the software on your computer that manages your files. +* **GitHub/GitLab** is the "Cloud Drive" that stores those files and adds social and professional tools on top of them. + +## Why is Hosting Essential for Developers? + +### 1. The Ultimate Backup +If your computer crashes, is stolen, or breaks, your code is safe. By running `git push`, you are sending a copy of your entire project history to a secure server. You can download it back onto a new machine in seconds. + +### 2. Collaboration & Open Source +Hosting services allow multiple people to work on the same project. +* **Pull Requests:** You can propose changes to someone else's code. +* **Code Review:** Teammates can leave comments on specific lines of your code to help you improve. + +### 3. Visibility & Portfolio +For a **CodeHarborHub** student, your hosting profile (like GitHub) is your **Digital Resume**. Employers don't just want to see that you *can* code; they want to see the actual code you’ve written, how you document it, and how you interact with others. + +### 4. Automation (CI/CD) +Hosting platforms integrate with "Continuous Integration and Continuous Deployment" tools. +* Every time you push code, the server can automatically run tests to make sure you didn't break anything. +* It can then automatically deploy your website to the internet. + +## How it Works: Local vs. Remote + +When you use a hosting service, you are dealing with two versions of your repository: + +1. **Local Repository:** The one sitting on your hard drive (where you work). +2. **Remote Repository:** The one sitting on the cloud server (where the "official" version lives). + +```mermaid +graph LR + A[Your Computer] -- git push --> B((Hosting Service)) + B -- git pull --> A + C[Teammate's Computer] -- git push --> B + B -- git pull --> C + +``` + +## Summary Checklist + +* [x] I understand that hosting services provide a remote home for my code. +* [x] I know that hosting is required for collaborating with other developers. +* [x] I recognize that my GitHub profile acts as a professional portfolio. +* [x] I understand the basic "Push/Pull" relationship between local and remote. + +:::tip Pro-Tip +Even if you are working alone, always host your code! It builds a habit of frequent saving and prepares you for the way professional teams operate. +::: \ No newline at end of file