Ce mémo a été publié le 12 décembre 2015 et peut contenir des informations qui peuvent être incomplètes, non mises à jour voir erronées du fait de son ancienneté. N'hésitez pas à compléter votre recherche sur des articles plus récents.
5/5 - (1 vote)

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 »

NetBeans - 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.

NetBeans - Nom du projet

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.

NetBeans - Serveur web

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 ».

NetBeans - Framework

Le projet est en place et prêt à recevoir votre travail.

NetBeans - Mon projet de test Git et 1and1

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 ».

NetBeans - Initialize a Git Repository

Pour faire simple, sélectionnez l’emplacement par défaut et validez.

Dans la fenêtre « Output », voici ce que vous devriez avoir :

NetBeans - Git output

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 » :

NetBeans - Git - Commit - Mon projet de test Git et 1and1

Résultat dans le fenêtre « Output » :

NetBeans - Git - Mon projet de test Git et 1and1

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 :

Vérifiez ces informations à l’aide de cette commande :

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 :

Exécutez cette commande qui va créer le répertoire prj_test_git_1and1.git et initialiser le dépôt :

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 !)

NetBeans - Push to Remote Repository - Git Repository Location

Si vos paramètres sont justes, vous devriez avoir cet écran.
il permet de choisir la branche locale à envoyer :

NetBeans - Push to Remote Repository - Local branche

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.

NetBeans - Push to Remote Repository - Remote branche

A la question « Do you want to set up branch « master » to track the remote branch? », répondez « Yes ».

NetBeans - Set Up Remote Tracking?

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.