mirror of
https://github.com/PowerShell/PowerShell
synced 2026-06-08 12:12:50 +00:00
Merge pull request #826 from PowerShell/andschwa/remove-omi
Remove OMI and PSRP
This commit is contained in:
@@ -1,10 +1,3 @@
|
||||
[submodule "src/omi"]
|
||||
path = src/omi
|
||||
url = https://github.com/Microsoft/omi.git
|
||||
branch = psrp/features
|
||||
[submodule "src/omi-provider"]
|
||||
path = src/omi-provider
|
||||
url = https://github.com/PowerShell/psl-omi-provider.git
|
||||
[submodule "src/windows-build"]
|
||||
path = src/windows-build
|
||||
url = https://github.com/PowerShell/psl-windows-build.git
|
||||
|
||||
+1
-1
@@ -10,7 +10,7 @@ before_install:
|
||||
- ./download.sh
|
||||
- sudo dpkg -i ./powershell.deb
|
||||
script:
|
||||
- powershell -c "Import-Module ./PowerShellGitHubDev.psm1; Start-PSBuild; Start-PSxUnit; Start-PSPester"
|
||||
- powershell -c "Import-Module ./PowerShellGitHubDev.psm1; Start-PSBuild; Start-PSPester"
|
||||
notifications:
|
||||
slack:
|
||||
secure: sKYd4n61+ZFzGZuWGUl8V1kN0NM16wRVOFVlNhlFCwnkrEsKROb++EvXf5uwnKuzxkhEjvPWO+UFgeshQDoR93y4s5YLfhC5JupK4nUzjPzWs208KTrh8u/x9MY8X6Ojxi85EEAiku5GzMoMlkucSStZUYwbIfnelzqdw8uoRwmm2MW4XCPwsuEuDUVghyiva0Mdx1G6MopCrK8T96WywJXT3chhfZQgVt+sQCBt9g+2kjDaObKrzG0P07IVK43ZpDgnu6AoxlyBzIx9mJH2Oa/tki3/kTO72Wcp3ps3qvmiStADamzVKR9p1VlWCLWAd6VOehxuByCGEyujpzk135Wud2DZYO+8LD6inZVhFe3Wt5pCU9BDXZppiATfMCqgXEH7nK54pEn79yHcjthRJ2+Z9ot7As2fu3RSBmTAi8nRP0fxRyX/jctR3S6P0qt0y1ynx9nzBfhmhPQW0PMVazWS/nruQIvK/3iiYXjZxM5bBwIvabmwV00EYeTdbL6ufXWNgQcG1ZWkDsi2I3vst/ytUbHwaFYg83bXWpxg9DCzJeWLVUvE5/3NfBxRAuCTot/fgTEA9IYScvrlL7Q/bT0cOt0vEM98MPf1UO+WP85uxhsRgHtwDEo+jMaL6ZFkPhlV6mmmED4NdY2//a571cLNXdnuMAze5O3TWGBG53g=
|
||||
|
||||
@@ -26,7 +26,7 @@ Get PowerShell
|
||||
|
||||
| | Linux | Windows .NET Core | Windows .NET Full | OS X | PSRP |
|
||||
|-----------------------|-------|-------------------|-------------------|------|------|
|
||||
| Build from **Source** | [Instructions](docs/building/linux.md) | [Instructions](docs/building/windows-core.md) | [Instructions](docs/building/windows-full.md) | [Instructions](docs/building/osx.md) | [Instructions](docs/building/psrp.md) |
|
||||
| Build from **Source** | [Instructions](docs/building/linux.md) | [Instructions](docs/building/windows-core.md) | [Instructions](docs/building/windows-full.md) | [Instructions](docs/building/osx.md) | [Instructions][psrp] |
|
||||
| Get **Binaries** | [Releases][] | [Artifacts][] | [Artifacts][] | [Releases][] | TBD |
|
||||
|
||||
Building summary: `Start-PSBuild` from the module
|
||||
@@ -38,6 +38,7 @@ instructions.
|
||||
|
||||
[releases]: https://github.com/PowerShell/PowerShell/releases
|
||||
[artifacts]: https://ci.appveyor.com/project/PowerShell/powershell-linux/build/artifacts
|
||||
[psrp]: https://github.com/PowerShell/psl-omi-provider
|
||||
|
||||
Team coordination
|
||||
-----------------
|
||||
@@ -67,6 +68,32 @@ rules, and Git best practices.
|
||||
|
||||
Clone this repository. It is a "superproject" and has a number of
|
||||
other repositories embedded within it as submodules. *Please* see the
|
||||
contributing guidelines and learn about submodules. Not every
|
||||
submodule is required on every system; see the individual build
|
||||
instructions for the necessary subsets.
|
||||
contributing guidelines and learn about submodules. To make things
|
||||
easy, we can just clone recursively.
|
||||
|
||||
```sh
|
||||
git clone --recursive https://github.com/PowerShell/PowerShell.git
|
||||
```
|
||||
|
||||
You can verify that the submodules were initialized properly with:
|
||||
|
||||
```sh
|
||||
git submodule status
|
||||
```
|
||||
|
||||
If they're initialized, it will look like this:
|
||||
|
||||
```
|
||||
f23641488f8d7bf8630ca3496e61562aa3a64009 src/Modules/Pester (f23641488)
|
||||
c99458533a9b4c743ed51537e25989ea55944908 src/libpsl-native/test/googletest (release-1.7.0)
|
||||
e6bf85694ae8352d77175c4c7d304946e018808c src/windows-build (monad/cc6afbeb-3/31)
|
||||
```
|
||||
|
||||
If they're not, there will be minuses in front (and the folders will
|
||||
be empty):
|
||||
|
||||
```
|
||||
-f23641488f8d7bf8630ca3496e61562aa3a64009 src/Modules/Pester (f23641488)
|
||||
-c99458533a9b4c743ed51537e25989ea55944908 src/libpsl-native/test/googletest (release-1.7.0)
|
||||
-e6bf85694ae8352d77175c4c7d304946e018808c src/windows-build (monad/cc6afbeb-3/31)
|
||||
```
|
||||
|
||||
@@ -59,17 +59,9 @@ Git Setup
|
||||
---------
|
||||
|
||||
Using Git requires it to be setup correctly; refer to the
|
||||
[README](../../README.md) and
|
||||
[Contributing Guidelines](../../CONTRIBUTING.md).
|
||||
|
||||
Please clone the superproject (this repo) and initialize a subset of
|
||||
the submodules:
|
||||
|
||||
```sh
|
||||
git clone https://github.com/PowerShell/PowerShell.git
|
||||
cd PowerShell
|
||||
git submodule update --init -- src/windows-build src/Modules/Pester src/libpsl-native/test/googletest
|
||||
```
|
||||
|
||||
Build using our module
|
||||
======================
|
||||
|
||||
|
||||
@@ -1,106 +0,0 @@
|
||||
PowerShell Remoting Protocol
|
||||
============================
|
||||
|
||||
This guide supplements the [Linux instructions](./linux.md), as
|
||||
building PowerShell Remoting Protocol (PSRP) support first requires
|
||||
PowerShell on Linux built.
|
||||
|
||||
PSRP communication is tunneled through the Open Management
|
||||
Infrastructure (OMI) using the [OMI provider][].
|
||||
|
||||
> PSRP has been observed working on OS X, but the changes made to OMI to
|
||||
> accomplish this are not even beta-ready and need to be done correctly. They
|
||||
> exist on the `andschwa-osx` branch of the OMI repository.
|
||||
|
||||
[OMI provider]: https://github.com/PowerShell/psl-omi-provider/
|
||||
|
||||
Environment
|
||||
===========
|
||||
|
||||
Toolchain Setup
|
||||
---------------
|
||||
|
||||
PSRP requires the following additional packages:
|
||||
|
||||
```sh
|
||||
sudo apt-get install libpam0g-dev libssl-dev libcurl4-openssl-dev libboost-filesystem-dev
|
||||
```
|
||||
|
||||
Git Setup
|
||||
---------
|
||||
|
||||
Two additional submodules need to be initialized:
|
||||
|
||||
```sh
|
||||
git submodule update --init -- src/omi src/omi-provider
|
||||
```
|
||||
|
||||
The `src/omi` submodule requires your GitHub user to have joined the
|
||||
Microsoft organization. If it fails to check out, Git will give up and
|
||||
not check out further submodules either. Please follow the
|
||||
instructions on the [Open Source Hub][].
|
||||
|
||||
[Open Source Hub]: https://opensourcehub.microsoft.com/articles/how-to-join-microsoft-github-org-self-service
|
||||
|
||||
Building
|
||||
========
|
||||
|
||||
Run `./omibuild.sh` to build OMI and the provider.
|
||||
|
||||
This script first builds OMI in developer mode:
|
||||
|
||||
```sh
|
||||
pushd src/omi/Unix
|
||||
./configure --dev
|
||||
make -j
|
||||
popd
|
||||
```
|
||||
|
||||
Then it builds and registers the provider:
|
||||
|
||||
```sh
|
||||
pushd src/omi-provider
|
||||
cmake -DCMAKE_BUILD_TYPE=Debug .
|
||||
make -j
|
||||
popd
|
||||
```
|
||||
|
||||
The provider maintains its own native host library to initialize the
|
||||
CLR, but there are plans to refactor .NET's packaged host as a shared
|
||||
library.
|
||||
|
||||
Running
|
||||
-------
|
||||
|
||||
Some initial setup on Windows is required. Open an administrative command
|
||||
prompt and execute the following:
|
||||
|
||||
```cmd
|
||||
winrm set winrm/config/Client @{AllowUnencrypted="true"}
|
||||
winrm set winrm/config/Client @{TrustedHosts="*"}
|
||||
```
|
||||
|
||||
> You can also set the `TrustedHosts` to include the target's IP address.
|
||||
|
||||
Then on Linux, launch `omiserver` (after building with the
|
||||
instructions above):
|
||||
|
||||
```sh
|
||||
./psrp.sh
|
||||
```
|
||||
|
||||
Now in a PowerShell prompt on Windows (opened after setting the WinRM client
|
||||
configurations):
|
||||
|
||||
```powershell
|
||||
Enter-PSSession -ComputerName <IP address of Linux machine> -Credential $cred -Authentication basic
|
||||
```
|
||||
|
||||
> The `$cred` variable can be empty; a credentials prompt will appear, enter
|
||||
> any fake credentials you wish as authentication is not yet implemented.
|
||||
|
||||
The IP address of the Linux machine can be obtained with:
|
||||
|
||||
```sh
|
||||
ip -f inet addr show dev eth0
|
||||
```
|
||||
@@ -47,17 +47,9 @@ Git Setup
|
||||
---------
|
||||
|
||||
Using Git requires it to be setup correctly; refer to the
|
||||
[README](../../README.md) and
|
||||
[Contributing Guidelines](../../CONTRIBUTING.md).
|
||||
|
||||
Please clone the superproject (this repo) and initialize a subset of
|
||||
the submodules:
|
||||
|
||||
```sh
|
||||
git clone https://github.com/PowerShell/PowerShell.git
|
||||
cd PowerShell
|
||||
git submodule update --init -- src/windows-build src/Modules/Pester
|
||||
```
|
||||
|
||||
Build using our module
|
||||
======================
|
||||
|
||||
|
||||
-1
Submodule src/omi deleted from 6fbc8b0b62
Submodule src/omi-provider deleted from 4f49eae9a8
Reference in New Issue
Block a user