Generate a .pem file to be the key for the chrome extension.
(In parent dir) Run the following command to generate an extension.
/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --pack-extension=./fleetd-chrome --pack-extension-key=path/to/chrome.pem
To learn how to package and add hosts to Fleet, visit: https://fleetdm.com/docs/using-fleet/enroll-hosts#enroll-chromebooks.
View service worker logs in chrome://serviceworker-internals/?devtools (in production), or in chrome://extensions (only during development).
Steps 1 and 2 can be performed on your workstation. Step 3 and 4 are to be executed on the target Chromebook.
- Create your .env file:
IMPORTANT: The address in
FLEET_URL
must have a valid TLS certificate.
echo 'FLEET_URL="https://your-fleet-server.example.com"' >> .env
echo 'FLEET_ENROLL_SECRET="<your enroll secret>"' >> .env
To test with your local Fleet server, you can use Tunnelmole or ngrok.
Tunnelmole:
tmole 8080
ngrok:
ngrok http https://localhost:8080
- Build the "unpacked extension":
npm install && npm run build
The above command will generate an unpacked extension in ./dist
.
-
Send the
./dist
folder to the target Chromebook. -
In the target Chromebook, go to
chrome://extensions
, toggleDeveloper mode
and click onLoad unpacked
and select thedist
folder.
npm run test
Release a new version via GitHub automation. Update the package.json and updates.xml versions, then tag a commit with fleetd-chrome-vX.X.X
to kick off the build and deploy. The build is automatically uploaded to R2 and properly configured clients should be able to update immediately when the job completes. Note that automatic updates seem to only happen about once a day in Chrome -- Hit the "Update" button in chrome://extensions
to trigger the update manually.
Beta releases are pushed to https://chrome-beta.fleetdm.com/updates.xml
with the extension ID bfleegjcoffelppfmadimianphbcdjkb
.
Kick off a beta release by updating the package.json and updates-beta.xml versions, then tag a commit with fleetd-chrome-vX.X.X-beta
to kick off the build and deploy.