Subir archivos a un repositorio de Bitbucket

  En el mundo de la informática existen entornos virtuales de colaboración conocidos como forjas.

  En esencia, una forja es una plataforma de desarrollo colaborativo de software. Se enfoca hacia la cooperación entre desarrolladores para la difusión de software y el soporte al usuario.
  En este tipo de plataformas se albergan múltiples proyectos de software, en los que los desarrolladores se deben registrar para poder contribuir. Consta de numerosas aplicaciones, normalmente con interfaz de red, para la administración y desarrollo de estos proyectos en común.

  Entre los recursos de una forja se encuentran: El control de versiones (Subversion, Git, Mercurial, etc.), una lista de correo electrónico, un foro, una wiki, herramientas de subida y descarga de ficheros, y un sistema de seguimiento de errores (Bugzilla, etc.).

  Las forjas más populares son Github, Gitlab, Bitbucket, SourceForge y, en España, RedIRIS, pero existen muchas más.

  La presente entrada está orientada a la forja Bitbucket, que es un servicio de alojamiento basado en web, para los proyectos que utilizan el sistema de control de versiones Mercurial y Git. Esta forja ofrece planes comerciales y gratuitos. Se ofrece cuentas gratuitas con un número ilimitado de repositorios privados (que puede tener hasta cinco usuarios en el caso de cuentas gratuitas) desde septiembre de 2010, los repositorios privados no se muestran en las páginas de perfil (si un usuario sólo tiene depósitos privados, el sitio web dará el mensaje "Este usuario no tiene repositorios"). El servicio está escrito en lenguaje Python.

  Para acceder a Bitbucket, como sucede con las otras forjas, se debe emplear un navegador de red, y el usuario, como ya se ha comentado anteriormente, debe registrarse en el portal web (en el formulario de registro, salvo si las circunstancias necesitan lo contrario, es mejor elegir un tipo de cuenta individual).

  Una vez recién registrado, el usuario puede configurar el portal desde el lugar apropiado y comenzar a crear repositorios y proyectos (la mejor opción es utilizar la que permite comenzar desde cero).

  Para crear un repositorio, se debe ir al panel izquierdo y pulsar en el símbolo "+".

  En el mismo lado que el panel anterior, aparecerá el menú de creación de esta forja. Se selecciona la opción "Repositorio" de la sección "CREAR" si se desea crear uno nuevo, o en la misma opción de la sección "IMPORTAR" si de quiere importar un repositorio ya creado (para este ejemplo se creará uno nuevo).

  En el panel derecho de la pantalla aparecerá el formulario para crear el repositorio en Bitbucket. Se le debe poner un nombre en el recuadro adecuado (en este ejemplo, "Prueba"), y es mejor desmarcar el recuadro del nivel de acceso y seleccionar el sistema de control de versiones Git para facilitar el proceso de futuras subidas de archivos. Finalmente, se pulsará en el botón "Crear repositorio".

   Seguidamente, en el equipo informático local se debe instalar el programa Git, lo que en sistemas operativos de Linux se hará mediante el comando apt-get install git (anteponiendo sudo si no se está como administrador), mientras que en sistemas operativos de Windows se deberá descargar el archivo de instalación de la página oficial e instalarlo como cualquier otro programa.

  A continuación, es recomendable crear un directorio en el equipo informático local (preferiblemente en C:) para alojar el repositorio a sincronizar con el de Bitbucket. Esto se logra, en Windows, desde el Símbolo del sistema (mejor si se abre como administrador) mediante el comando md <nombre del directorio> (o mkdir <nombre del directorio>).

  Si el equipo informático tiene un sistema operativo Linux, dicho directorio se crea con el comando mkdir <nombre del directorio> (anteponiendo sudo si no se está como administrador) preferiblemente en el directorio del usuario. Pero, además, se deben dar permisos al directorio mediante el comando chmod -R 777 <nombre del directorio> (anteponiendo sudo si no se está como administrador).

   De vuelta en la página de Bitbucket, puede verse que en panel derecho muestra unas instrucciones de los pasos a seguir.

  Sin embargo, existen un par de pasos más que es necesario realizar para evitar problemas entre la página y el equipo local. En primer lugar, se activa la consola del programa Git en el equipo local (en este caso, simplemente se ha abierto un menú contextual en el escritorio de Windows y se ha pulsado en la opción "Git Bash Here", pero puede abrirse también desde el menú de inicio o como cualquier otro programa instalado en Windows).

 Teniendo en cuenta que esta consola funciona con comandos propios de UNIX (esté instalada en un sistema operativo de Linux o no), se debe acceder hasta el directorio antes creado para el repositorio en el equipo informático local y, una vez dentro, se deberá utilizar el comando git clone <dirección del repositorio en la página de Bitbucket> (este comando se podrá copiar en la propia página y pegarlo en la consola). Puede comprobarse el resultado mostrando el nuevo directorio recién creado tras la sincronización.

  Acto seguido, se puede continuar con la primera parte del paso 2 explicado en el sitio web de la forja (se puede copiar el comando y pegarlo directamente en la consola de Git o copiarlo a mano). Sin embargo, antes de subir cualquier archivo a dicho sitio web, lo mejor es confirmar el nombre del usuario (con el que se haya registrado este) y su correo electrónico (el que se haya empleado durante el registro) en el equipo local; para la primera confirmación, se empleará el comando git config --global user.name <nombre de usuario de Bitbucket>, y para la segunda se utilizará el comando git config --global user.email <dirección de correo electrónico del usuario en Bitbucket>.

  Se comprueba la situación del archivo a subir (en este ejemplo, "LEAME.txt") mediante el comando git status (viendo que no ha sido adecuadamente agregado al repositorio).

  Para solucionar esto, se emplea el comando git add <nombre del archivo>, y se vuelve a comprobar con el comando antes mencionado.

  Con todo esto preparado, se creará un mensaje representativo para el archivo que se va a subir mediante el comando git commit -m <mensaje> (en este ejemplo, el mensaje será "Primera subida").

  Finalmente, y siguiendo de nuevo las instrucciones del sitio web Bitbucket, se realizará la instrucción de la segunda parte del paso 2 de estas (como en algunas veces anteriores, puede copiarse y pegarse directamente o escribirse el comando adecuado).

  El resultado puede verse en el repositorio creado en el sitio web de la forja (puede verse el archivo recién subido con las siguientes características: nombre, tamaño, tiempo desde la última subida, y el mensaje).

  Pulsando sobre el nombre del archivo dos veces con el botón izquierdo del ratón podrá verse su contenido.

  Aguardo que la presente entrada haya sido del gusto del lector; si es así, espero que la comente y/o la comparta, por favor.