Initialize Iceberg Github communication - maxbareis/pharo GitHub Wiki

Summary

This page will explain the settings you need to make in Pharo to let Iceberg communicate with your Github repositories.

You need an account in Github for this to work.

Setting credentials

You will need to set a valid set of credentials in your system to be able to access Github. In case you use SSH (the default way), you will need to make sure those keys are available. In case they are not (and you will notice as soon as you try to clone a project or commit a change into one), you can add them following this steps:

  • in linux, execute in your shell:
    ssh-add ~/.ssh/id_rsa
  • in OSX, execute in your shell:
    ssh-add -K ~/.ssh/id_rsa

Both for OSX and linux you can add such lines in your .bash_profile (or the one corresponding to your shell installation) so they are automatically executed on each new shell session.

  • in windows is more complicated, you may need to generate a pair of keys (that needs to be uploaded to your account on github).
    • You can follow instructions on how to generate your keys here.
    • Then you need to go to settings browser, search for "Use custom SSH keys" and complete your data there.
    • Alternatively, you can execute in your image playground:
IceCredentialsProvider useCustomSsh: true.
IceCredentialsProvider sshCredentials
	publicKey: 'path\to\ssh\id_rsa.pub';
	privateKey: 'path\to\ssh\id_rsa'

Pro Tip:: this can be used too in case you have a non default key file, you just need to replace "id_rsa" with your file name.

As soon as you have set your credentials in your system you need to tell Github that those credentials are allowed to access your repositories. You can find the ssh and GPG page in the settings section of your profile. See Github Help for detailed instructions.

Test connection

  1. Create and open a new Image for example in PharoLauncher (see Install Pharo)
  2. Open Iceberg
  3. Repair Repository Your repository is probably outdated as the distribution images have been created with older versions. Therefore you need to get the repositories in sync by cloning again from github. See Repair Repository. If this works your credentials are set up alright.