סקירה כללית

הצגת המקור ב-GitHub

OpenThread Border Router (OTBR) תומך ב-Docker, ואפשר להריץ אותו בקונטיינר של Docker במקום ישירות במכונה המקומית.

המדריך הזה מתמקד בהרצת Docker OTBR ב-Raspberry Pi (RPi) או בכל מכונה המבוססת על Linux, והוא נבדק רק בפלטפורמות האלה.

הגדרת Raspberry Pi

מתקינים את מערכת ההפעלה Raspberry Pi OS עם מחשב שולחני ב-RPi. פועלים לפי ההוראות בשלב הורדה והתקנה של מערכת ההפעלה מהסקירה הכללית של Raspberry Pi, אבל חשוב להשתמש ב-Raspberry Pi OS במחשב עם מערכת ההפעלה.

אחרי ההתקנה, מפעילים את ה-RPi ופותחים חלון טרמינל.

  1. עדכון המערכת:

    sudo apt-get update
    sudo apt-get upgrade
    

  2. מתקינים Docker:

    curl -sSL https://get.docker.com | sh
    
  3. אם רוצים להשתמש ב-Docker כלא ברמה הבסיסית (root), בלי לדרוש sudo לפני כל פקודה, צריך לשנות את הגדרות המשתמש. כדי שהשינויים ייכנסו לתוקף, צריך לצאת מהחשבון:

    sudo usermod -aG docker $USER
    

  4. מפעילים את Docker אם הוא לא פועל:

    sudo dockerd
    

  5. התקנת git:

    sudo apt install git
    

  6. סקריפטים של חומת אש מסוג OTBR יוצרים כללים בתוך הקונטיינר של Docker. מריצים את הפקודה modprobe כדי לטעון את מודולים הליבה של iptables:

    sudo modprobe ip6table_filter
    

הגדרת Linux

פועלים לפי אותן ההוראות של הגורם המוגבל:

  1. עדכון המערכת:

    sudo apt-get update
    sudo apt-get upgrade
    

  2. מתקינים את Docker:

    curl -sSL https://get.docker.com | sh
    

  3. אם רוצים להשתמש ב-Docker כלא ברמה הבסיסית (root), בלי לדרוש sudo לפני כל פקודה, צריך לשנות את הגדרות המשתמש. כדי שהשינויים ייכנסו לתוקף, צריך לצאת מהחשבון:

    sudo usermod -aG docker $USER
    

  4. מפעילים את Docker אם הוא לא פועל:

    sudo dockerd
    

  5. התקנת git:

    sudo apt install git
    

  6. סקריפטים של חומת אש מסוג OTBR יוצרים כללים בתוך הקונטיינר של Docker. מריצים את הפקודה modprobe כדי לטעון את מודולים הליבה של iptables:

    sudo modprobe ip6table_filter
    

Mac או Windows

כדי להשתמש ב-OTBR Docker ב-Mac או ב-Windows, מתקינים את Docker Toolbox. האפשרות הזו נדרשת כי הרצת OTBR באמצעות Docker כוללת טעינה של יציאות טוריות וירטואליות, שנתמכת רק על ידי Docker Toolbox במערכות האלה.

הורדת תמונת ה-Docker של OTBR

מורידים את קובץ האימג' של OTBR באמצעות Docker באופן ישיר מ-OpenThread Docker Hub, או על ידי שכפול מאגר ה-OTBR ופיתוח מקומי של קובץ ה-Docker הכלול.

מומלץ לשלוף את התמונה מ-Docker Hub, מכיוון שהיא נבדקה ואומתה על ידי צוות OpenThread.

שליפת התמונה מ-Docker Hub

תמונה זו היא מתאריך מזהה ההתחייבות e80def4.

  1. מושכים את התמונה:

    docker pull openthread/otbr:latest
    

  2. עכשיו הוא אמור להופיע ברשימת התמונות של Docker:

    docker images
    REPOSITORY           TAG          IMAGE ID           CREATED           SIZE
    openthread/otbr      latest       98416559dcbd       2 weeks ago       1.15GB
    

יצירת קובץ ה-Docker

כדי ליצור את התמונה בעצמכם, משכפלים את המאגר OpenThread Border Router ויוצרים את קובץ ה-Docker הכלול.

  1. משכפלים את מאגר ה-OTBR:

    cd ~
    git clone https://github.com/openthread/ot-br-posix
    cd ot-br-posix
    

  2. יוצרים את קובץ ה-Docker:

    docker build --no-cache -t openthread/otbr -f etc/docker/Dockerfile .