Rozwiązywanie problemów z synchronizacją

Na tej stronie znajdziesz informacje o rozwiązywaniu problemów związanych z poleceniem repo sync.

Rozwiązywanie problemów z siecią

W tej sekcji znajdziesz kilka sugestii dotyczących rozwiązywania problemów z siecią, które mogą powodować nieudane synchronizacje.

Używanie uwierzytelniania, aby uniknąć ograniczeń związanych z limitem

Aby chronić serwery przed nadmiernym wykorzystaniem, każdy adres IP używany do uzyskiwania dostępu do źródła jest powiązany z limitem.

Gdy udostępniasz adres IP innym użytkownikom, na przykład podczas uzyskiwania dostępu do repozytoriów źródłowych spoza zapory NAT, mogą zostać uruchomione limity w przypadku zwykłych wzorców. Limit może zostać przekroczony, gdy kilku użytkowników w krótkim czasie zsynchronizuje nowych klientów z tego samego adresu IP.

Aby uniknąć przekroczenia limitów, możesz użyć uwierzytelnionego dostępu, który korzysta z osobnego limitu dla każdego użytkownika niezależnie od adresu IP.

Aby włączyć uwierzytelnianie:

  1. Utwórz hasło za pomocą generatora haseł.

  2. Aby przekształcić klienta w klienta korzystającego z automatycznego uwierzytelniania (bez zmiany gałęzi), uruchom to polecenie:

    $ repo init -u https://android.googlesource.com/a/platform/manifest
    

    Pamiętaj, że prefiks katalogu /a/ powoduje automatyczne uwierzytelnianie.

Konfigurowanie proxy

Jeśli pobierasz źródło za pomocą serwera proxy, co jest powszechne w niektórych środowiskach korporacyjnych, pamiętaj, aby wyraźnie określić serwer proxy, którego ma używać Repo. Aby to zrobić, uruchom te polecenia:

$ export HTTP_PROXY=http://proxy_user_id:proxy_password@proxy_server:proxy_port
$ export HTTPS_PROXY=http://proxy_user_id:proxy_password@proxy_server:proxy_port

Dostosowywanie ustawień TCP/IP, aby uniknąć problemów z połączeniem

Chociaż zdarza się to rzadko, klienci Linuxa mogą mieć problemy z połączeniem, na przykład podczas pobierania i odbierania obiektów. Aby rozwiązać ten problem, dostosuj ustawienia stosu TCP/IP lub użyj połączeń nierównoległych. Aby zmienić ustawienie TCP, musisz mieć dostęp roota. Aby zmodyfikować to ustawienie, wykonaj te polecenia:

$ sudo sysctl -w net.ipv4.tcp_window_scaling=0
$ repo sync -j1

Używanie lokalnego lustra, aby uniknąć opóźnień w sieci

Jeśli używasz kilku klientów, możesz utworzyć lokalny klon całego serwera i synchronizować klientów z tego klonu bez dostępu do sieci. Aby utworzyć lokalny klon w ~/aosp-mirror/ i zsynchronizować z nim klientów, wykonaj te czynności:

  1. Tworzenie i synchronizowanie lustrzanego obrazu:

    $ mkdir -p /usr/local/aosp/mirror
    $ cd /usr/local/aosp/mirror
    $ repo init -u https://android.googlesource.com/mirror/manifest --mirror
    

    Te polecenia tworzą lokalny klon w /user/local/aosp/mirror i inicjują klon za pomocą flagi --mirror w ramach polecenia repo init.

  2. Aby zsynchronizować klientów z lustra:

    $ mkdir -p /usr/local/aosp/main
    $ cd /usr/local/aosp/main
    $ repo init -u /usr/local/aosp/mirror/platform/manifest.git
    $ repo sync
    
  3. Na koniec wykonaj te polecenia, aby zsynchronizować lustro z serwerem i synchronizować klienta z lustrem:

    $ cd /usr/local/aosp/mirror</code>
    $ repo sync
    $ cd /usr/local/aosp/main
    $ repo sync
    

Można przechowywać lustro na serwerze LAN i uzyskiwać do niego dostęp przez NFS, SSH lub Git. Można je też przechowywać na dysku wymiennym i przekazywać między użytkownikami lub urządzeniami.

Używanie częściowego klona

Jeśli używasz Git w wersji 2.19 lub nowszej, podczas wykonywania polecenia repo init podaj parametr --partial-clone, aby rozwiązać problemy z siecią o niskim opóźnieniu:

  $ repo init -u https://android.googlesource.com/platform/manifest -b main --partial-clone --clone-filter=blob:limit=10M

Zamiast inicjowania repozytorium w celu pobrania wszystkiego, to polecenie pobiera obiekty Git w miarę potrzeby.

Rozwiązywanie konkretnych problemów z synchronizacją

Na tej stronie znajdziesz informacje o niektórych znanych problemach, które mogą wystąpić podczas synchronizowania kodu źródłowego Androida.

Polecenia nie działają z powodu błędu 403 lub 500 (problemy z serwerem proxy)

Polecenia repo init lub repo sync mogą się nie udać z błędem 403 lub 500. Najczęściej te błędy są związane z serwerami proxy HTTP, które mają problemy z obsługą dużych transferów danych.

Nie ma konkretnego rozwiązania tych błędów, ale czasami może pomóc korzystanie z najnowszej wersji Pythona i wyraźne użycie repo sync -j1.