Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

39 instruction mac #130

Open
wants to merge 9 commits into
base: master
Choose a base branch
from
Open

39 instruction mac #130

wants to merge 9 commits into from

Conversation

AdamBelloum
Copy link
Collaborator

created guide for self-hosted runner using MacOS as a client side.

Setting the networking part on MacOS did not work with the setting on Linux ubuntu. The best I could find is to add a second adapter and set it to Host-only Adapter. When a VM is started an IP address is assigned to it 192.168.1.XXX. Log using tester account and get the acctual address using ifconfig
changed the stat command . on Mac it does not support -c option
minor changes to the ubuntu guide. the guide works on MacOS
@AdamBelloum AdamBelloum requested a review from fdiblen July 12, 2020 21:43
```shell
> docker --version

Docker version 19.03.11-ce, build 42e35e61f3
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is your docker version the same?

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

yes that was the version I tested with I have now updated to Docker version 19.03.12, build 48a66213fe

## Prerequisites
Install Docker: https://docs.docker.com/docker-for-mac/install/
for more information to get started with docker for MacOS https://docs.docker.com/docker-for-mac/

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Did you need to follow post-installation steps?

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actually not, it just work directly. the only thing which does not work on MacOS is the Docker dashboard (still does not work for me) but we don't needed for self-hosted runner

The Docker image will create a user called ``tester`` with a password ``password``. If you want to change the default username and the password, you will need to adjust `<username>` and `<user password>` for the user which will be added to the Docker image.

```shell
docker build \
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Do you need to use sudo to run docker commands?

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

On Mac I did not have to use Sudo to issue docker commands, but when I installed docker, I got the message which required me to enter admin password to install docker.

prompt: "What is the GitHub repository for which you want to enable this self-hosted runner?"
private: no
- name: "TOKEN"
prompt: "Please enter the GitHub Actions token for this workflow. Go to https://github.com/<org>/<repo>/settings/actions/add-new-runner and copy it from the 'Configure' section."
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think you need to merge master in to this branch to get updates from mater branch.
Also, as far as I remember, we updated this playbook for Ubuntu. Could you please check the updates?


## Prerequisites

1. Install VirtualBox on the client: https://www.virtualbox.org/wiki/Linux_Downloads
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is a download link for Linux.


## Server side configuration

1. Create a new virtual machine in VirtualBox. It's recommended to give it at least 4 GB memory, 2 CPUs, and 20 GB disk space (dynamically allocated).
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I guess the interface and the buttons are identical with Linux version. Are they?

Ansible is a tool with which you can do so-called _provisioning_, i.e. automated system administration of remote
machines. We'll use it to set up the GitHub Actions runner.

Install Ansible from Ubuntu's repositories:
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

These are Ansible installation instructions for Ubuntu. Can you please add Mac instructions?

ansible --version
```

(Find more information [here](https://docs.ansible.com/ansible/latest/installation_guide/intro_installation.html#installing-ansible-on-ubuntu)).
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This link is for Ubuntu.

**Note: ``id_rsa`` is the private half of the SSH key pair; don't share it with anybody else.**

```shell
cd ubuntu-virtualbox/
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

it should be cd mac-os-virtualbox

### Generate SSH key pair

Generate a key pair (files ``id_rsa`` and ``id_rsa.pub``) in directory
[``/ubuntu-virtualbox/``](/ubuntu-virtualbox/) using RSA encryption:
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

These paths are for ubuntu guide.

UserKnownHostsFile /dev/null
StrictHostKeyChecking no
PasswordAuthentication no
IdentityFile /home/verhoes/git/NLESC-JCER/linux_actions_runner/ubuntu-vagrant/.vagrant/machines/default/virtualbox/private_key
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This path is for ubuntu-vagrant guide.

Copy link
Collaborator

@fdiblen fdiblen left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you very much @AdamBelloum!
I requested some changes. It would be very nice if you could fix these.

@fdiblen
Copy link
Collaborator

fdiblen commented Oct 2, 2020

@AdamBelloum are you planning to work on this PR?

@fdiblen
Copy link
Collaborator

fdiblen commented Nov 6, 2020

@AdamBelloum any updates?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

2 participants