# 2. Konfiguracja środowiska
# 2.1. Pobranie repozytorium i instalacja paczek
Do pracy z projektami akeneo potrzebujemy mieć przygotowane środowisko na serwerze dostarczone przed backend developera. Samo repozytorium sciągamy lokalnie z gitlaba jak w innych projektach.
git clone https://git.macopedia.pl/nasze-repozytorium.git
Po sciągnięciu plików należy zainstalować wymagane dependencje komendą yarn, tak jak zawsze.
# 2.2. Ustawienia połączenia
Pierwszą rzeczą jaką należy skonfigurować jest sposób w jaki chcemy się łączyć z serwerem na którym znajduje się środowisko. Wybieramy: tools->deployment->configuration, wtedy powinno pojawić się następujące okno konfiguracji połączeń:
Typ połączenia wybieramy na SFTP, root path wskazujemy na główny folder projektu a SSH configuration ustawiamy klikając w 3 kropki.
Host ustawiamy na adres serwera, user name w tym przypadku jest to nazwa maila. Na koniec należy dodać jako authentication type jako key pair oraz podać sieżkę do niego.
# 2.3. Dodanie remote hosta
Remote hosta ustawiamy klikając w pozycję Remote Host z prawej strony okna edytora. Wybieramy z listy rozwijanej połączenie, który zostało dodane w kroku pierwszym. Teraz mamy dostęp do plików znajdujących się na serwerze. Jeśli mamy brakujące foldery w lokalnych plikach można teraz pobrać je z romote hosta.
# 2.4. Ustawienie automatycznego dyploymentu
Automatyczny dyployment umożliwia nam automatyczne wysyłanie zapisanych plików na serwer. W przypadku odpalonego watchera na zdalnym środowisku, takie rozwiąznie znacznie usprawnia pracę ponieważ nie trzeba ręcznie wysyłać plików po każdej zmianie. Z paska górnego menu wybieramy tools->deployment->automatic upload
# 2.5. Podstawowe informacje o workflow i strukturze plików
Pracując z akeneo tworzymy nowe lub nadpisujemy istniejące moduły w folderze src. Instniejące pliki akeneo które będą modyfikowane znajdują się w folderze vendor/akeneo. Na poniższym przykładzie widać dwie paczki od akeneo są to wersja community dostępna na githubie oraz płatna enterprise.
Domyślny watcher w projektach akeneo jest wywoływany przez komendę: yarn run webpack-dev --watch. Przy zmianach w plikach .yml należy przebudować frontend ponownie z wykorzystanie komendy make front.