Deze documentatie leert hoe u de DXPR builder-repository kunt klonen en deze kunt gebruiken voor lokale ontwikkeling en het lokaal uitvoeren van DXPR-maven-tests.

Vereisten

Kloon en installeer DXPR Builder

  1. Open een terminal. Als u Windows gebruikt, zorg er dan voor dat dit de Ubuntu-terminal is die u hebt ingesteld in de installatiehandleiding van de machine.
  2. cd naar een map waarin u uw webprojecten opslaat. Bijvoorbeeld /mnt/d/dxpr/
  3. Kloon de DXPR Builder-repository: git clone [email protected]:dxpr/dxpr_builder.git .
  4. Open de projectmap in uw favoriete teksteditor.
  5. Kopieer het bestand .env.example en hernoem het naar .env
  6. Open het .env- bestand en stel de variabele DXPR_ACCESS_TOKEN=[access_token] in en sla het bestand op , dwz. negeer de vierkante haakjes. U kunt uw token verkrijgen via de downloadpagina op dxpr.com op het tabblad JSON Web Token​.

  7. Nu je alles hebt ingesteld, voer je gewoon het volgende script uit in de map dxpr_builder door deze opdracht te typen en te wachten tot de site succesvol is geïnstalleerd. ./scripts/qa-demo.install.sh .
    Dit zou enkele minuten moeten duren voordat je zoiets als dit ziet:

     mijn_drupal9_project_qa_demo | [opmerking] Uitgevoerde installatietaak: install_finished
mijn_drupal9_project_qa_demo | [succes] Installatie voltooid.
mijn_drupal9_project_qa_demo | [30-jul-2021 09:18:32] LET OP: fpm is actief, pid 1
mijn_drupal9_project_qa_demo | [30-jul-2021 09:18:32] LET OP: klaar om verbindingen te verwerken

    U hoeft de install-opdracht slechts één keer uit te voeren, de volgende keer voert u gewoon ./scripts/qa-demo.sh uit

  8. Open de browser en navigeer naar http://drupal.docker.localhost:8000/
  9. Nu kunt u het project in elke editor openen, bijvoorbeeld. VSCode - en begin met het wijzigen van bestanden. Na het opslaan voert de stapel automatisch de grunt-taken uit, bouwt de activa indien nodig opnieuw op en blijft kijken naar veranderingen. U kunt de logboeken in de terminal bekijken als u moet controleren op eventuele gruntfouten bij het bouwen van activa.
  10. Om de stapel te stoppen, drukt u op CTRL + c . Het is altijd een goede manier om uw omgeving op te ruimen nadat u de stapel hebt gestopt. Voer gewoon deze opdracht uit: ./scripts/qa-demo.cleanup.sh

Moet ik elke keer dat ik de stack uitvoer, wachten op de demo-installatie?

Gelukkig is dat niet het geval. De volgende keer dat je de stack moet uitvoeren, voer je gewoon ./scripts/qa-demo.sh uit, waardoor de website binnen enkele seconden wordt gestart. Als je de stapel wilt stoppen, doe dan hetzelfde als vermeld in stap 8 in het gedeelte Klonen en instellen hierboven.

Testen uitvoeren

Als u de stappen in de sectie Klonen en instellen hebt gevolgd, voert u voor het uitvoeren van tests het volgende uit: ./scripts/qa-demo.test.sh . Als dat niet het geval is, volgt u gewoon het gedeelte Klonen en instellen . Zorg er ook voor dat u de opdrachten qa-demo.install.sh of qa-demo.sh stopt voordat u de testopdracht uitvoert.

Probleemoplossen

  • Zorg er altijd voor dat u uw .env bestand instelt voordat u doorgaat met het opsporen van fouten en zorg ervoor dat daar niets ontbreekt.
  • Als uw .env -bestand goed is, probeer dan de momenteel actieve opdracht te stoppen en voer de opdracht ./scripts/qa-demo.sh uit voordat u verder gaat. Hiermee wordt de stapel opgeruimd en wordt de QA-demo- installatie opnieuw gestart.
  • Als het nog steeds niet werkt, is uw QA-demo-installatie mogelijk beschadigd. De beste manier van handelen is om de stack opnieuw te installeren. Ctrl+c om de momenteel actieve opdracht af te sluiten, voer vervolgens deze opdracht uit: ./scripts/qa-demo.install.sh en volg stap 5 tot en met 8 zoals eerder gedefinieerd in de sectie Klonen en instellen . Als dat commando fouten oplevert, stop dan en voer het opnieuw uit.
  • Zorg er altijd voor dat u geen van de opdrachten qa-demo.install.sh , qa-demo.sh of qa-demo.test.sh tegelijkertijd uitvoert, zelfs als ze zich in verschillende terminals bevinden, omdat dit fouten zal opleveren. u moet elke lopende opdracht stoppen en vervolgens de gewenste uitvoeren.
  • Voor Mac- gebruikers: zorg ervoor dat u de vereiste libs. Volg deze StackOverflow- thread.

De demo van Bootstrap 4 of 5 installeren

  • Maak nog een map met de dxpr_builder-code, bijvoorbeeld door de bestaande map te kopiëren

  • Bewerk het .env-bestand om de omgeving naar Bootstrap 5 (of 4) te schakelen:

     ### DXPR-THEMA-INSTELLING

### Te gebruiken DXPR-themaafbeelding, dwz productie.

DXPR_THEME_TAG= 5.x

  • Pas de projectinstellingen aan om conflicten met de Bootstrap 3-demo te voorkomen door bs5 toe te voegen aan de onderstaande variabelen en het poortnummer te verhogen:

     ### PROJECTINSTELLINGEN

# verander naar een andere naam voor het geval er andere instanties met dezelfde naam draaien

PROJECT_NAME= dxpr_builderbs5_project

PROJECT_BASE_URL= drupalbs5.docker.localhost

### De netwerknaam die de qa-demo-site gebruikt bij het uitvoeren van de docker-stack in de dxp_builder

QA_DEMO_NETWORK= qabs5-demo

# wijzig naar een andere poort voor het geval andere instanties op poort 8080 draaien

PROJECT_POORT= 8002
  • Om Bootstrap 4 in plaats van 5 te installeren, vervangt u in het bovenstaande 5.x door 2.x en vervangt u "bs5" door "bs4"
  • Open de demo op http://drupal.docker.localhost: 8002/ waarbij het poortnummer (8002) het nummer is dat u in het .env-bestand hebt ingevoerd
  • Voer nu ./scripts/qa-demo.install.sh uit zoals gewoonlijk