Mémo pour configurer NetBeans avec Git et un dépôt distant sur 1and1.
Objectif
1and1 offre la possibilité d’héberger sur son serveur web des projets Git.
Cette fonction n’est disponible qu’uniquement sur les serveurs Linux.
Dans ce (gros) mémo, nous allons configurer NetBeans pour utiliser un dépôt Git local et le sauvegarder sur un dépôt Git distant.
NetBeans – Nouveau projet
C’est à dire sur votre machine de développement.
Exécutez NetBeans et créez un nouveau projet.
« File > New Project »
Pour ce mémo, je reste simple et je choisis « PHP > PHP Application »
Ensuite, il faut donner un nom au nouveau projet. Par exemple : « Mon projet de test Git et 1and1 »
Le champ « Sources Folder » indique l’emplacement de stockage des sources sur votre ordinateur.
Il est forcément différent des sources réellement utilisées par le site web.
Mais pas obligatoire. Surtout si vous utilisez Wamp par exemple.
Dans ce cas, je configure toujours mon projet NetBeans pour que les fichiers sources soient copiés dans le répertoire c:\wamp\www\mon_projet\
Je ne travaille jamais directement sur les sources du site web.
Configurez NetBeans pour que les fichiers soient copiés dans le répertoire du site web en cours de développement.
Dans mon cas, j’utilise un serveur et un nom de domaine local test.jbnet.lan. Les fichiers du site web sont stockés dans le répertoire « /home/jerome/www/prj_test_git_1and1 ».
La lise déroulante « Run as » liste les différentes utilisation possibles, à vous de choisir en fonction du besoin.
Puis il est possible d’utiliser un framework comme Symfony. Dans ce mémo, je n’utilise ni framework, ni composer.
Donc ,cliquez directement sur « Finish ».
Le projet est en place et prêt à recevoir votre travail.
Git local
Maintenant que le projet est créé, nous allons déclarer un dépôt Git local pour gérer les sources.
Cliquez-droit sur le nom du projet (ici : « Mon projet de test Git et 1and1 ») puis « Versioning > Initialize a Git Repository ».
Vous pouvez aussi utiliser le menu « Team ».
Pour faire simple, sélectionnez l’emplacement par défaut et validez.
Dans la fenêtre « Output », voici ce que vous devriez avoir :
Effectuez un premier « Commit » pour initialiser le début du travail.
Cliquez-droit sur le nom du projet, puis « Git > Commit »
Dans la zone de texte « Commit message », saisissez un texte genre « Init du projet » :
Résultat dans le fenêtre « Output » :
Déjà vous pouvez commencer à travailler et utiliser votre Git local pour gérer vos sources.
Git Distant
Nous allons maintenant créer un dépôt sur votre hébergement 1and1 afin de sauvegarder les sources ailleurs que sur votre poste de travail ou de pouvoir travailler à plusieurs sur un même projet…ou encore vous permettre de travailler sur différentes machines avec les mêmes sources.
Connectez-vous en SSH sur votre hébergement 1and1.
Comme indiqué sur la page d’aide de 1and1, il faut d’abord configurer un nom d’utilisateur et une adresse e-mail :
1 2 |
command git config --global user.name "JBNet" command git config --global user.email monemail@domaine.ndd |
Vérifiez ces informations à l’aide de cette commande :
1 |
command git config --list |
A la racine de votre hébergement (qui ne devrait pas être la racine de votre site web ! ), créez un répertoire pour accueillir vos projets (ex : git) puis allez dans ce répertoire :
1 2 |
command mkdir git command cd git |
Exécutez cette commande qui va créer le répertoire prj_test_git_1and1.git et initialiser le dépôt :
1 |
command git init --bare prj_test_git_1and1.git |
Le dépôt distant du projet est créé.
NetBeans et un dépôt Git distant
Maintenant que nous avons un projet qui possède un dépôt Git local et que nous avons un dépôt Git distant, il ne reste plus qu’à les lier dans NetBeans.
Donc, la suite suite se passe dans NetBeans.
Cliquez-droit sur le nom du projet puis « Git > Remote > Push… »
Dans l’écran « Push to Remote Repository », sélectionnez « Specify Git Repository Location: »
- Remote name : le nom du dépôt créé via l’accès SSH. ex : « prj_test_git_1and1 »
- Repository URL : « ssh://jbnet.fr/~/git/prj_test_git_1and1.git/ »
- Username : utilisateur ssh
- Password : mot de passe ssh
L’URL du dépôt est très importante, notamment la présence du tilde pour indiquer la racine de la session SSH, c’est à dire la racine de votre hébergement.
(Et c’est là que j’ai pas mal galéré au début !)
Si vos paramètres sont justes, vous devriez avoir cet écran.
il permet de choisir la branche locale à envoyer :
Cochez la case « master » puis cliquez sur le bouton « Next »
L’écran suivant permet de sélectionner la branche distante à utiliser.
Même chose que pour la branche locale puis validez.
A la question « Do you want to set up branch « master » to track the remote branch? », répondez « Yes ».
Félicitation !
A partir de maintenant, votre projet NetBeans qui utilise déjà un dépôt Git local, est capable également d’utiliser votre dépôt Git distant sur votre hébergement 1and1.