migrate

2026-07-20 09:23:17 -04:00
parent c1315882da
commit 72272e4006
3179 changed files with 562960 additions and 14 deletions
@@ -0,0 +1,33 @@
+---
+tags:
+  - Scirpts
+  - Desktop
+---
+# 🚀 System Preparation: APT Package Management Guide
+
+This guide outlines the mandatory, standard procedure for updating and upgrading all packages on a Debian/Ubuntu based system using the **Advanced Package Tool (APT)**. Maintaining updated repositories is foundational to system security and stability.
+
+## Process Overview
+The process requires two distinct steps: first refreshing the package index, and second, applying the actual updates.
+
+### 1\. Update Local Package List (`apt update`)
+This command contacts the configured repository servers and downloads the latest available package lists. **It does not install any packages.** It only ensures *knowing* what is available.
+
+```bash
+sudo apt update
+```
+
+### 2\. Full System Upgrade (`apt upgrade` or `apt full-upgrade`)
+After verifying the index, you must run one of these commands:
+*   **`sudo apt upgrade`**: Recommended for routine maintenance. It performs an in-place upgrade of all installed packages to their newest versions, while generally respecting current package dependencies and avoiding large system changes.
+*   **`sudo apt full-upgrade` (Recommended for major changes)**: Use this when upgrading between major OS releases or when a core dependency update might require the installation/removal of related packages. This gives more "freedom" to upgrade beyond simple minor patch levels.
+
+## Important Troubleshooting Steps
+If an upgrade fails, it is almost always due to:
+1.  **Broken Dependencies:** A package required by another service has been removed or updated incompatibly.
+2.  **Repository Interruption:** Network connectivity issues prevented the full index update.
+
+In such cases, check the specific error logs provided by `apt` and search official Ubuntu/Debian documentation for known dependency conflicts involving those packages.
+
+> [!NOTE] Modernized Workflow
+For managed environments (like Container Orchestration, e.g., Kubernetes), direct host package management should be minimized. Instead of running `apt upgrade` on the host OS itself, it is best practice to **define dependencies strictly within your Dockerfile or application manifests**. This ensures that every deployment unit carries its tested environment dependencies, guaranteeing consistency across development, staging, and production stacks.